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PREFACE 


This publication describes the internal logic of the CVOL 
processor program and provides diagnostic information. This 
information is directed to maintenance personnel and development 
programmers who require in-depth knowledge of the program's 
design, organization, and data areas. It is not required for 
affective use of the CVOL processor. 


Nicer aa be familiar with the following before reading this 
ook: 


e General programming techniques 

e OS/VS2 concepts and use 

e General concepts of catalog management 
e System/370 


The information in the following manuals, as they apply to the 
CVOL processor, should ba understood before you read this 
publication: 


6 MVS/7Extended Architecture Catalog User's Guide, GC26-4041, 


for an introduction to the CVOL processor. 


e VS/Extended Architecture al Diagnosis Reference, 
SY26-3837, for information on VSAM Catalog Management. 


Other publications that this book references and that you may 
find helpful are: 


e MVS/Extende rehitecture Messa ibrary: tem Messa 
G6C28-1156, for VSAM Catalog Management return codes. (See 
the chapter "Access Method Services Messages (IBC)" for 
these messages.) 


e MVS/7Extended Architecture [50 Command processor Logic, 
Yolume IV, SY33-8548-3, for information on he TSO LISTCAT 
command 


e OS/VS-DOS/VSE-VM/370 Assembler Language, GC33-4010, for an 


explanation of Assembler language. 


e 0S/VS-VM/370 Assembler Programmer's Guide, GC33-4021, for 


information on using Assembler language. 


e ssembler _ H Version 2 Application Programming: Language 
Reference, GC26-4037, for an explanation of Assembler H 
language. 

° sembler H Version Application Programmin Guide, 


pagan 4036, for information on using Assembler ar 


e MVS/Extended Architecture Data Management Services, 
G6C26-4013, for a general introduction to Catalog Management, 


as well as information on generation data groups. 


° MVS/7Extended Architecture Access Method Services Reference 
for the Integrated Catalog Facility, GC26-4019, which 
describes the general syntax of the Access Method Services 


language, the commands of this processor, and how they are 
used. 


e vs f/Extended Architecture Access Method Services Reference 
for VSAM Cat alogs, GC26-4075, which describes the access 
method services in relation to VSAM catalogs. 
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e MVS/Extended Architecture Debugging Handbook, Volumes 1 
through 5, GBOF-1015, which describes how to analyze a main » 
storage dump from MVS/XA, and which shows the content of ) 
Cerne the operating system control blocks and tables for 
MVS/XA. 


6 MVS/Extended Architecture System Programming Library: 
Service Aids, GC28-1153, which describes several service 
aids and programs available under the VS2 operating system. 


6 MVS/Extended Architecture Supervisor Services and Macro 
Instructions, GC28-1154, and OS/VS2 System Programming 
Library: Supervisor,, GC28-1046 for information on the ESTAE 
macro, and authorized operands. 


e Vocabulary for Data Processing, Telecommunications, and 
Office Systems, GC20-1699, for other data processing 


definitions not found in the glossary of this publication. 
This book is divided into six chapters: 


6 "Introduction" on page 1 describes the CVOL processor and 
defines the terms used throughout the book. 


6 "Method of Operation™ on page 4 provides the design 
overview. Emphasis is on the flow of data and the concepts 
of the CVOL processor, rather than on the organization of 
the CSECTs. 


6 "Program Organization" on page 13 describes each CSECT of 
the CVOL processor. and identifies the specific function that 
each CSECT performs to achieve the CVOL processor 
objectives. This chapter shows the logical flow from CSECT 
to CSECT and contains the flowcharts of the CSECTs. 
. "Microfiche Directory™ on page 86 relates information in | 
this book to the listings on microfiche. a 


° "Data Areas" on page 92 describes the work areas that are 
used by the CVOL processor. 


© "Diagnostic Aids" on page 114 shows you how to determine 
what CSECTs and subroutines are used for a particular 
atid tena It also shows how to dump and analyze the CVOL 
atalog. 


This publication also includes a glossary and an index. 


In this manual, any references made to an IBM program product 

ara not intended to state or imply that only IBM's program 

product may be used; any functionally equivalent program may be 

used instead. This manual has references to the following IBM 

program product: "RACF-Resource Access Control Facility, Program ° 
Number 5740-XXH." 
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INTRODUCTION 


OVERVIEW 


This book describes the logic of the CVOL processor program. 

The CVOL processor program is based on the OS catalog management 
function. It gets data from and puts data into CVOLs (control 
volumes), which can be created under OS, OS/VS1 Rel. 1, OS/VS2 
MVS, or MVS/XA DFP. 


Figure 1 shows the flow of control through the CVOL processor. 













User Request 
OS/VS or VSAM 
SVC 26 


Controller II 















CVOL Catalog 


Management 


Interface 


VSAM Catalog 


Management Mappers 


[_ CVOL Processor 


ee —_—_  —_— —_— or ——_ to — ——— 


Figure 1. Flow of Control to the CVOL Processor 


Notes to Figure 1: 


1. Khen an SVC 26 instruction is issued, controller III 
CIGCOO002F) receives control. SVC 26 passes a parameter list 
to controller III. The parameter list has two possible 
formats. VSAM or OS, depending upon the cype of request. 


2. Controller III tests the parameter list. If it is an OS 
parameter list which specifies a CVOL volume serial, 
controller III simply passes this request to the CVOL 
processor. If it is an OS parameter list without a CVOL 
volume serial, controller III creates a VSAM parameter list 
and passes the OS parameter list and the newly created VSAM 
parameter list to VSAM catalog management. If it is a VSAM 
parameter list, controller III simply passes it on to VSAM 
catalog management. 


3. VSAM catalog management searches the VSAM catalog for the 
data set requested in the VSAM parameter list. If VSAM 
finds an alias to a SYSCTLGx data set in the VSAM master 
catalog, it gives control to the CVOL processor (IGGOCLCA) 
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via an XCTL. (The "x" in the SYSCTLGx term represents one 
or more characters that make this name unique from any other 
entry in the VSAM master catalog). VSAM passes both control 
and the parameter list(s) from controller III on to the CVOL 
processor. 





4. After the CVOL processor has processed the SVC request, it 
returns control directly to the program that issued the SVC 
26 instruction. 


REQUIREMENTS OF THE CVOL PROCESSOR 


PURPOSE AND FUNCTION 


The CVOL processor's objective is to provide support for CVOLs 
within the single (VSAM) master catalog environment of MVS. The 
CVOL processor permits the use of existing CVOLS in a multiple 
processor environment when running OS, OS/VS1, OS/VS2, or MVS/XA 
without converting back and forth between the types of catalog 
structures supported by each operating system. 


If a request 15 made for a catalog VSAM function against a CVOL 
catalog, the CVOL processor maps the request into an 0S request 
and performs the catalog function. For more information on how 
the CVOL processor operates, see “Method of Operation" on page 
4. For a list of requests and what the CVOL processor maps them 
into, as well as a list of requests that the CVOL processor does 
Hk: ag ee read the introduction of the IBM publication Catalog 
ser's Guide. 


PHYSICAL CHARACTERISTICS 


The CVOL processor occupies 20,000 bytes of storage and consists . 

of one load module named IGGOCLCA. It resides in SYS1.LPALIB . 
and can be paged into real storage. The IGGOCLCA load module 

contains six CSECTs: IGGOCLCA, IGGOCLCB, IGGOCLCC, IGGOCLCD, 

IGGOCLCE, and IGGOCLCF. 


The program organization of the CVOL processor can be thought of 
as two sections: the interface mappers and CVOL catalog 
management. The interface mappers consist of CSECTs IGGOCLCA 
and IGGOCLCB. CVOL catalog management consists of CSECTs 
IGGOCLCC, IGGOCLCD, IGGOCLCE, and IGGOCLCF. For more 
information on the subroutines and their use within each CSECT, 
see "Microfiche Directory" on page 86. 


When the CVOL processor gains control, register 12 points to the 

work area, WORKCLCA, that is passed by VSAM catalog management. 
(Controller III creates WORKCLCA and passes it to VSAM catalog ; 
management. See Figure 5 on page 14 and “Data Areas" on page 92 

for a description of WORKCLCA. ) 


If the request is successful, the data .5 returned as expected 
by the original OS or VSAM request. Register 15 contains zero. 
If the request is not successful, the CVOL processor passes a 
return code in register 15 to the issuer of the SVC 26. For a 
list of return codes and their meanings, refer to "CVOL 
Processor Exit and Output™ on page 15 of this publication. For 
a list of control information required and any restrictions on 
the use of the CVOL processor, refer to the IBM publication 


Catalog User's Guide. 


To determine which subroutine within the CVOL processor is 

involved in any given situation, see Figure 15 on page 115 and 

Figure 16 on page 121 in this publication. For more information 

on diagnostic aids for the CVOL processor, see "Diagnostic Aids" 

on page 114. ) 
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Note: Secause all CVOL catalogs ara named “"SYSCTLG," the terms 
"CVOL catalog” and "SYSCTLG" are uzed interchangeably in this 
documentation. 
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ETHOD OF OPERATION 





This chapter contains method-of-operation diagrams of the main 
elements of the CVOL processor. A table is included as part of 
each diagram which lists each step of the diagram, the CSECTs 
name, and the subroutines used. Using these names, you can go 
either to "Program Organization” on page 13 or to “Microfiche 
Directory™ on page 86 (or to the microficha itself) for more 
information. 


Figure 2 explains the symbols used in the diagrams and Figure 3 
explains the abbreviations used in the diagrams. 


=. > Data flow 


Lg Flow of control, entry and exit points 





UZZL/> Data flow when existing data has been changed 


4 On-page connector 
+» Off-page connector 


—> Pointer to more information 


Figure 2. Symbols Used in This Chapter 
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Communication vector table An operating system control block 
| that contains pointers to 
operating system routines and 
other system data areas. 


Data set pointer entry Contains the simple name of a 
data set and provides the 
location of this data set. 


ee ee index pointer Points to the lowest index for a 
entry generation data group. 


Index link entry links this block to the next 
block itn a chain of blocks for 
one index. 


Index pointer entry Points to a lower-level index of 
this name. 


Supervisor request block An operating system control block 
containing program status 
information and general register 
contents. 


Task control block An operating system control block 
that contains information and 
pointers associated with the task 
in progress. 





Figure 3. Abbreviations Used in the Diagrams 
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Overview 


Interface Mappers CVOL Catalog Management 


Determines type 
of request 


Gets Information 


2.0 3.0 


Sets Up 


Generic Locate 





Figure 4. CVOL Processor Visual Table of Contents 
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DIAGRAM 2.0. INTERFACE MAPPERS (DETERMINES TYPE OF REQUES 
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OCE 


The CVOL processor consists of one load module named IGGOCLCA 
that resides in SYS1.LPALIB. (See "Physical Characteristics" on 
page 2 for an overall conceptual description of the CVOL 
processor. Also see Figure 1 on paga 1 for an overview of the 
flow of control to the CVOL processor. ) 


VOCATION AND INPUT 


The CVOL processor, module IGGOCLCA, gains control via an XCTL 
from Controller III, module IGCO002F, when an OS/VS type catalog 
request is issued which specifies a CVOL volume serial in tha 
parameter list. il.parameter list 


The CVOL processor, module IGGOCLCA, also gains control via an 
XCTL from VSAM catalog management, module IGGOCLAlL, when VSAM 
finds an alias to a SYSCTLGx data set in the VSAM Master 
catalog. (Where x is one or more characters that make this name 
unique from any other entry in the VSAM Master catalog.) This 
alias entry indicates that the data set requested by SVC 26 
resides on a CVOL catalog. 


The CVOL processor uses a non-standard convention for linkage. 
Register 1 points to a parameter list that is needed by the CVOL 
processor. Register 12 points to the work area named WORKCLCA 
that was created by Controller III. When the CVOL processor 
gets control, it puts the address of its own save area in 
register 13 and saves registers in that save area. Register 15 
contains the entry point address of IGGOCLCA. Register 14 is 
not used. Figure 5 on page 14 illustrates the key fields within 
WORKCLCA that the CVOL processor depends upon. 
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VSAM Request 


Repvister [2 











WORKCLCA 
Catalog Alias 
CVOL volser = 0 


CTGPLPTR 
CAMPLPTR 







Original VSAM 
parny list 





OS Request without a CVOL volser 









Reeister 12 


cL 





WORKCLCA 


Catalog Name 
C; 


CVOL volser = 0 





| 















CTGPLPTR VSAM version 
CAMPLPTR of OS parm list 
Se 


OS Request with a CVOL volser 
Register 12 Original OS 
parm list 
(no CVOL 
volser) 


CVOL volser ew 


Original OS 




















és parm list 
CTGPLPTR = 0 (including CVOL 
CAMPLPTR Olser) 


re ox 


Figure 5. WORKCLCA at Processor Invocation 
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Notes to Figure 5: 
( 1. If the parameter list passed to SVC 26 indicates a VSAM 
request, CTFPLPTR and CAMPLPTR point to the VSAM parameter 
list. 


2. If the parameter list passed to SVC 26 indicates an 05 
request, CAMPLPTR points to the OS parameter list. 


3. If the OS parameter list specifies a CVOL volser, then 
CTGPLPTR is zero, the CVOL volume serial field has been 
filled in by Controller III, and the catalog name and alias 
fields remain uninitialized. If the OS parameter list 
specifies no CVOL volser, then CTGPLPTR points to the VSAM 
parameter list created by Controller III, and the CVOL 
volume serial field is set to binary zeros. The catalog 
name and alias fields are filled in by VSAM catalog 
management. 


CVOL PROCESSOR EXIT AND OUTPUT 


CVOL processor returns control to the issuer of the SVC 26. If 
no errors were encountered, register 15 contains zero. If an 
error has occurred, register 15 always contains a return code 
indicating the type of error. In some cases registers 0 and 1 
provide further information concerning the error; when the 
contents are significant, the meaning is noted below. The 
meaning of the return code varies according to the type of 
catalog request: 


e If the request is a VSAM request, register 15 contains a 
return code defined by VSAM catalog management. These 


return codes are explained in Message Library: System 
Messages, in the chapter called "Access Method Services 


( Messages (IDC)." 
e If the request 1s an OS request, register 15 contains one of 
the return codes described in the following lists. 
e If the 0S request was satisfied in a VSAM catalog, and 
Register 15 does not contain a 0, Register 0 contains the 


VSAM catalog management return code. 


Refer to the following lists for return code meanings. 


OS LOCATE MACRO RETURN CODES 
If processing an OS locate request, register 15 may contain: 


Code Reason 


0 Successful. 

4 Either the required CVOL catalog does not exist, could not 
be allocated, or an MSS (Mass Storage System) acquire 
failed. 

8 One of the following: 

e Entry not found. RO contains number of index levels. 


® Protection violation. RO=56. 


e GDG alias found. RO contains number of index levels. 
12 Non-data set found at last qualifier. RO contains number 
of index levels. 
( 16 Data set exists at an earlier level of qualification. RO 
contains number of index levels where data set was 
encountered. 
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20 Syntax error in data set name. 
24 One of the following: 


1. Permanent I/O error. RO=VSAM return code or 0 if 
error in CVCL. 


2. Unrecoverable error Cincluding 'Do not allocate’). 
RO=0. 


3. Nonzero ESTAE return code. RO=0. 
4. Error in CAMLST. RO=0. 


28 TTR 185 out of range. 


OS INDEX MACRO RETURN CODES 


OS CATALOG, 


16 


When processing an OS BLDX, DLTX, LNKX, BLDG, BLDA, DLTA, or 
DRPX request, register 15 may contain: 


Code Reason 


0 Successful. 
4 CVOL not available. 
8 Catalog structure inconsistent with specified operation. 


RO same as RO on a LOCATE on this name. R1 same as R15 on 
a LOCATE on this name. 


12 Can't delete a nonempty index. 
16 Necessary index structure does no exist. 
20 Space unavailable in catalog. 


28 One of the following: 
1. Permanent I/O error. 


2. Nonzero ESTAE return code. 


UNCATALOG, OR RECATALOG RETURN CODES 


When processing an OS CATALOG, UNCATALOG, or RECATALOG request, 
register 15 may contain: 


Code Reason 
0 Successful. 


G Either the required CVOL catalog does not exist, or the 
CVOL catalog cannot be allocated or acquired. 


8 One of the following: 
1. Catalog structure inconsistent with the operation 
requested Cincluding alias for GDG found). RO same as 
RO on a LOCATE on this name. R1 same as R15 ona 
LOCATE on this name. 
2. Protection violation. RO0=56. R1=0. 


20 Insufficient space on a CVOL catalog data set. Register 0 
contains zero. 


24 Improperly named generation data group not cataloged. 
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28 


One of the following: 


1. <A permanent I/0 error or an unrecoverable error 
occurred. 


2. An error was found in the OS parameter list. 
3. An I/0 error occurred ina CVOL catalog. 


4. An ESTAE return code was nonzero. 


VSAM SUPERLOCATE RETURN CODES WHEN ACCESSING CVOL 


When processing a VSAM SUPERLOCATE request, register 15 may 
contain: 


Code Reason 


0 
4 


24 
44 
68 
164 


Successful. 


Allocation error occurred or unable to open a CVOL 
catalog. 


Data set not found or the structure of the CVOL catalog 
was inconsistent. 


I/O error or unrecoverable error. 
Insufficient space available to CVOL processor. 
The CVOL catalog cannot be allocated. 


ESTAE return code was nonzero. 


OTHER VSAM REQUEST RETURN CODES WHEN ACCESSING CVOL CATALOGS 


When processing VSAM requests other than SUPERLOCATE, register 


15 may contain: 


code 
0 
46 
8 


24 


28 


40 
48 
164% 


Reason 
Successful. 
Allocation error or unable to open a CVOL catalog. 


Data set not found or the structure of the CVOL catalog 
was inconsistent. 


I/O error or unrecoverable error trying to locate 
information. 


I/O error or unrecoverable error on any request action 
except trying to locate information. 


Insufficient space. 
Invalid function, not consistent with a CVOL catalog. 


ESTAE return code was nonzero. 
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OVERVIEW OF THE CVOL PROCESSOR ORGANIZATION 


1974,1982 


Figure 6 gives the overall program organization of the CVOL 
processor. The figure is followed by a description of each of 


the CSECTs that the CVOL processor contains. 





IGGOCLCA 


Determines type of request 


» 


IGGOCLCB 





Processes VSAM 
generic locate 
request 












IGGOCLCC 


Reads CVOL 
Catalog Entry 


IGGOCLCD 


Sets up CVOL 


catalog operation 









Processes CVOL 
catalog operation 


control directly to the 


Gives 
Ritirn program that issued the SVC 26 
Instruction, 


Figure 6. Overall Program Organization of the CVOL processor 
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INTERFACE MAPPERS 
CSECTs IGGOCLCA and IGGOCLCB are called the First and Second 
Interface Mappers because they map VSAM requests inte OS 
requests. 

CSECT IGGOCLCA 
CSECT IGGOCLCA, First interface mapper, is the entry and exit 
point for the CVOL processor. After ensuring that the PCCB 
(private catalog control block) is valid, IGGOCLCA determines 
what type of request has been sent to the CVOL processor and 
calls the appropriate subroutine. Figure 7 lists the types of 


requests IGGOCLCA honors, the subroutine that receives control; 
the action performed, and any other CSECTs called. 


Other CSECTs 
Type of Request Subroutine Action Performed Called 
OS CAMLST format Sets up and executes an IGGOCLCC 
|. original OS CAMLST format 
request. 


SUPERLOCATE SUPERLOCATE Determines type of IGGOCLCC 
without generic superlocate and calls the 
appropriate procedure: 
SLGDG, base generation 
number supplied; SLGDGB, 
| locate GDG base only 


locate specified 
VSAM delete DELETE Processes a VSAM delete IGGOCLCC 
request by issuing an O05 
SUPERLOCATE with GENLOC IGGOCLCB 
generic locate 
specified 


UCATDX request and 

optionally a SCRATCH. 

Access Method VLOC IGGOCLCC 

Services LISTCAT 

without GET NEXT 

option 

Figure 7. Requests to IGGOCLCA 
All other VSAM requests not listed in Figure 7 are rejected with 

a return code of 48 in register 15, and control is returned to 

the issuer of the SVC 26 instruction. 































Processes a VSAM generic 
locate. 













Processes an Access Method 
Services LISTCAT (Cnot GET 
NEXT) request. 





CSECT IGGOCLCB 


CSECT IGGOCLCB, Second interface mapper, produces a data set 
names found cataloged under the requested high-level qualifiers. 


Figure 8 on page 21 shows how the Segment (CIRBLOCK) entries are 
processed after the first segment block information is returned 
by CIR. This example assumes the "01° and °'02' option codes 
(data set names and index names) have been requested, and that 
the USERID is used a node point for the catalog search. 
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The catalog structure for this example is: 





USERID 
SETI SET2 
LEVEL] C D E 
eae See 


A B 


where SETL, SET2, and LEVELI are index names and A-E reprasent 
the lowest level, fully qualified, data set names. 
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1. Four segment blocks are initialized. 
C CURNTBLK and FRSTBLK are made to point CURNIBEK FRSTBLK 


to the first segment block. The current entry 
pointer is zeroed. IGGOCLCB then uses 


: : ; Current 
routine OBTBLK to find the first segment Chain Address fld Entry 4 


Re Ore ee ee eel 
pe a ee 
a 
ees ee eT, | AS 


block containing a zeroed current entry field. 


2. Then IGGOCLCB calls CIR, which reads the 


first index block and formats the entries. CURNTBLK FRSTBLK 


3. Control returns to IGGOCLCB, which then gets 
the CURNTBLK value, establishes a pointer 
to, and makes the current-entry field reflect the 
first entry (see MAINOQ). 


CURNTBLK FRSTBLK 


pA ST | SETY 7 SET2 Link Entry (zero TTR) 


4. IGGOCLCB analyzes the list entry (see label 
MAINO1) and finds it to be an index name. CURNTBLK FRSTBLK 


etree 


Control is then passed to routine INDEXRT, 
which sets up a parameter list for CIR and uses 
ee va are to get a a ced. for the — 
next lower level of qualifiers. (OBTBLK 

checks the chain, sees that the current-entry ESET SET Link Entry (zero TTR) _| 
pointer is not zeroed, gets the address of the 
next block in the chain and puts it in 
CURNTBLK.) 





8, OBTBLK returns control to INDEXRT, which 
calls CIR and reads the next block from the 
catalog. The current-entry pointer of the 
second block is updated to point at the first 
entry in that block. A check is then made to 


see if the entry is a link entry (in this case, no). PET A SET2 Link Entry (zero TTR) | 
Tt Ey eT 


CURNTBLK FRSTBLK 





6. Control returns to IGGOCLCB at MAINOI, 
which continues processing as in step 4. CURNTBLK FRSTBLK 


fs 
a 
i, 
es a a 
oe, EEE oman 


Figure 8 (Part 1 of 2). IGGOCLCB Example of Catalog Sagmant Block Handling 


C 
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1974,1982 





7. Control passes from INDEXRT to CIR, which 
reads in the block upon return to INDEXRT, 
the current-entry pointer is updated to point at 
the first entry of the third block. A check is 
made for a link entry in this position (in this 
case, no). 


8. Control is returned to IGGOCLCB, through 
label MAINO1, which tests for entry type and 
finds the data set name .SET}].LEVELI.A. 


9. After the current entry is processed, control is 
returned to the POINTER subroutine, which 
updates the current-entry pointer of the third 


segment block to point to the B entry. A check 


is made to see if it is a link-entry (in this case, 
no). 


10. Processing for .SETI.LEVELI1.B continues (as 
in steps 8 and 9). This time, when the 
current-entry pointer is updated, the POINTER 
subroutine finds a zeroed link-entry. The 
current-entry pointer of the third segment 
block is cleared, releasing the block for 
possible future use. CURNTLBK is updated to 
point to the second block. 


11. Control is returned to IGGOCLCB, through 
MAINO1, which updates the current-entry 
pointer of the current block to point to the 
next entry. The next entry is a data set name 
entry and is processed. 


12. The remainder of the operation ts summarized 
as follows: 


e When the zero-TTR in the second segment 
block is encountered, the block is released, 
and the CURNTBLK is updated to point to 
the first block. 


« The current-entry pointer is updated to 
point to SET2. SET2 is an index name, 
which means that CIR is entered to read 
into segment block 2. The new second-level 
information (D, E, and a zero-TTR link 
entry) overlays the old. 


« When no more entries remain to be 
processed (that is, when a zero-TTR link 
entry is encountered in the first segment 
block), the POINTER routine passes control 
to WRAPUP in IGGOCLCB, which cleans 
up and returns control to IGGOCLCA. 


rigure 8 (Part 2 of 2). 


CURNTBLK FRSTBLK 


om 
ee Wee el SET] = SET2 Link Entry (zero TTR) 
| oo™ 


fo ™ 


ae T LEVELT. 7% Cink Entry (zero TTR) 
BAY BL Link Entry (zero TTR) 













Link Entry 


CURNTBLK FRSTBLK 


fc 
CSET SER? _Lin Entry 

i ”™ 
a NS 7 
oo Oe 





CURNTBLK 


i 
LST SET2 Link Entry 


FRSTBLK 


PEL Link Entry 
cee ee el 





IGGOCLCB Example of Catalog Segmant Block Handling 
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System Macros Used by CSECTsS IGGOCLCA and IGGOCLCB 


Figure 9 lists all system macros used by CSECTs IGGOCLCA and 
IGGOCLCB and the label closest to each point of issue. 


[racro | esecr [sen 
Paecectea | srcnrece 


| IGGOCLCA | IGGOCLCA 
| ESTAEEXIT 
ESTAE 
IGGOCLCB ESTAEDK 
WRAPUP 


IGGOCLCA IGGOCLCA 

: WRAPUPOO 

FREEMAIN | IGGOCLCB WRAPUPO2 

| | FREEMMDL 
FREEML 






















IGGOCLCB 
GETMAIN IGGOCLCB OUTBLKO2 

GETMLMDL 

GETML 


LINK IGGOCLCA | IGGOCLCA 
IGGOCLCA | GETUSERK 
GETSVCK 
| MODESET 
IGGOCLCB | BUILDNAM 
OUTBLKO7 
RETURN IGGOCLCB | ERREXIT 
NORMEXIT 
SAVE IGGOCLCB | IGGOCLCB 
CIR 


SCRATCH IGGOCLCA DELETE 


Figure 9. System Macros Used by CSECTs IGGOCLCA and IGGOCLCB 


Resource Enqueuing for CSECTS IGGOCLCA and IGGOCLCB 


During catalog allocation, CSECT IGGOCLCA enqueues on a chain of 
private catalog control blocks (PCCBs). The major name for 
engqueuing 15 always SYSZPCCB, and the minor name for enqueuing 
15s always PCCB. cCSECT IGGCCLCB does not use resource enqueuing. 


During catalog allocation, IGGOCLCA also issues two EN@s to 
preserve data integrity. For both EN@s the minor name is 

SYSCTLG. Vxxxxxx, where xxxxxx 15 the volume serial of the 
CVOL. The major names used are (1) SYSZOPEN and (2) SYSDSN. 


The SYSDSN EN@ prevents the CVOL from being scratched during SVC 


26 processing. The SYSZOPEN ENQ is issued to prevent an 
unallocation that could dequeue the SYSDSN EN@. 
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Register Usage for the Interface Mappers 





Both interface mappers use registers in an identical manner, 
except as noted. 


Register Meaning 


10 Second base register for CSECT-IGGOCLCA only 
11 Base register for CSECT 
12 Base register for WORKCLCA structure 


CATALOG MANAGEMENT 
0S catalog management in the CVOL processor consists of four 


CSECTs: IGGOCLCC, IGGOCLCD, IGGOCLCE, and IGGOCLCF. The first 
three CSECTs contain the three 05 catalog management phases 


referred to in Catalog Diagnosis Reference. The three OS/VS 
phases contain eleven separate modules, while the four CVOL 


processor CSECTs contain eleven subroutines. Figure 10 gives a 
compartson of the four CVOL processor CSECTsS versus the three OS 
catalog management phases. 


| Modules Subroutines 
Contained ! CSECT Contained Comments 


IGGOCLCO IGGOCLCC IGGOCLCO IGGOCLCL and IGGOCLC2 


IGGOCLC1 IGGOCLC1 return to IGGOCLCA or 
IGGOCLC2 IGGOCLC2 IGGOCLCB, whichever called 
IGGOCLCD 
IGGOCLCE 


ITECPBLDL IGGOCLCC. IECPBLDL was 
IGGOCLCF 


previously a separate 
Figure 10. OS Catalog Management Compared to the New CVOL Catalog Management 






























service routine and 1s now 
included in IGGOCLCC. 


























IGGOCLC3 
IGGOCLC4 
IGGOCLC5 


IGGOCLC6 
IGGOCLC? 


IGGOCLC5 was previously 
included in Phase III. 


IGGOCLC3 
IGGOCLC4 




















IGGOCLC?7 returns to 
IGGOCLCA or IGGOCLCB, 
whichever called IGGOCLCC. 


IGC0002H calls IGG0553A for 
new extents. IGC0002H 

returns to caller, as does 
IGGOCLF2. IGGOCLF2 is only 
the SYSCTLG Formatter. 


IGGOCLCS5 
IGGOCLC6 
IGGOCLC? 


IGG0002H 
IGGOCLF2 











IGC0002H 
IGGOCLF2 















Program Organization of CSECTS IGGOCLCC, IGGOCLCD, IGGOCLCE, and IGGOCLCF 


CSECT IGGOCLCC, the entry point for CVOL catalog management, is 
called from CSECT IGGOCLCA or CSECT IGGOCLCB. IGGOCLCC passes 
control to CSECTs IGGOCLCD and IGGOCLCE via brancn instructions. 
IGC0002H, one of the service subroutines, is invoked via a 
branch instruction; it passes control to IGGOCLF2 via a branch 
instruction. The path that occurs through the remaining 
subroutines of the three CVOL catalog management CSECTs depends 
on both the particular function requested and the entries that 
are found tn the CVOL catalog. 


All the CVOL catalog management CSECTs are reentrant. They use ) 


a common work space, WORKAREA, that is initialized by IGGOCLCO. 
(See "Data Areas" on page 92 for a description of WORKAREA. ) 
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CSECT IGGOCLCC 


CSECT IGGOCLCD 


CSECT IGGOCLCE 


Each block in Figure 11 on page 26 represents a subroutine of 
the CVOL catalog management routines and contains a brief 
description of the functions it performs. Each path is 
identified by the function/condition it represents. 


Figure 11 gives the overall program organization of CSECTs 
IGGOCLCC, IGGOCLCD, IGGOCLCE, and IGGOCLCF. 


CSECT IGGOCLCC performs the read operation. IGGOCLCC performs 
locate functions and the locate part of nonlocate functions. A 
locate function is a LOCATE by NAME or LOCATE by TTR, that is, a 
read-only function. A nonlocate function is CATBX, UCATDX, 
BLDA, BLDG, DLTA, DLTX, LNKX, DRPX, or RECATLG, that is, an 
update function. 


e IGGOCLCO CInitialization) initializes work areas and opens 
the CVOL catalog. 


. IGGOCLC] (CRelative GDG and Alias) resolves aliases and 
relative GDG numbers. 


S IGGOCLC2 (Locate) searches the lower levels of the index 
structure. 


e IECPBLDL (Search) searches for the qualified name in the 
CVOL catalog. 


CSECT IGGOCLCD performs the setup operation for adding or 
deleting entries in the CVOL catalog. IGGOCLCD checks the 
validity of the requests against the existing entries in the 
CVOL catalog and builds new entries to be added or names entries 
to be deleted. IGGOCLCD consists of the following subroutines: 


e IGGOCLC3 (Update Initialization and Entry Building) begins 
the update process by building new index blocks and routing 
the request as needed. 


IGGOCLC4 CEntry Building) builds data set pointer entries to 
add to the last valid level of the index. 


e IGGOCLCS (First Load of Update) frees index blocks, frees 
volume control blocks (VCBs), and writes new VCBs. 


CSECT IGGOCLCE performs the write operation. It merges entries 
into CVOL catalog blocks, deletes entries from the blocks, and 
does most of the writing that is needed. IGGOCLCE consists of 
the following subroutines: 


° IGGOCLC6 (Second Load of Update) updates blocks, writes 
updated blocks to the CVOL catalog and ripples the changes 
as needed to the last block of the updated chain. 


e IGGOCLC?7 (Third Load of Update and Error Handling) writes 
the last updated block, updates the control entries, returns 
control to IGGOCLCA or IGGOCLCB (whichever called IGGOCLCC), 
and handles error conditions. 
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CSECT IGGOCLCF 


The two service subroutines includad in IGGOCLCF are: 


e IGCOOO2ZH CSYSCTLG Open/Extend) opens the CVOL catalog data 
set or gets the next extent of that data set when needed. 


e IGGOCLCF2 CSYSCTLG Formatter) formats a new CVOL catalog. 


Services Used by CSECTs IGGOCLCC, IGGOCLCD, IGGOCLCE, and IGGOCLCF 


Two services are used throughout the CVOL catalog management 
subroutinas. They are: 


e IECPCNVT converts relative track addresses to absolute 
addresses. It is accessed through entry point IJECPCNVT 
whose address is found in field CVTPCNVT of the 
Communication Vector Table (CVT). In the CVOL catalog 
management routines, this routine is used in the closed 
subroutine labeled "TQABSL." 


° IECPRLTV converts absolute track addresses to relative 
addresses. It is accessed through entry point IECPRLTV, 
whose address is found in field CVTPRLTV of the CVT. In the 
CVOL catalog management routines, this routine is used ina 
closed subroutine labeled "TORLTV." 


Character Dependency for CSECTs IGGOCLCC, IGGOCLCD, IGGOCLCE, and IGGOCLCF 


The CSECTs of CVOL catalog management require that the character 
set used at execution time be equivalent to that used at 
assembly time. The IBM-supplied version of CVOL catalog 
management assumes EBCDIC character representations. If a 
different character set is to be used during execution, the 
CSECTs must be re-assembled. The instructions involved in this 
dependency are identified by label in the prologue commentary of 
each CSECT. 


System Macros Used by CSECTS IGGOCLCC, 1IGGOCLCD, IGGOCLCE, and IGGOCLCF 


Figure 12 on page 28 lists all the executable system macros used 
by CSECTs IGGOCLCC, IGGOCLCD, IGGOCLCE, and IGGOCLCF and the 
label closest to each point of issue. 
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Figure 12 (Part 1 of 2). System Macros Used by CSECTs IGGOCLCC, 
IGGOCLCD, IGGOCLCE, and IGGOCLCF 
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RACHECK IGGOCLCC RACSETUP 
IGGOCLCD EXCP3 


WAIT 
IGGOCLCE EXCP1 
EXCP2 
IGGOCLCF 103 
IQ 


IGGOCLCF | RVIRTS 
IGGOCLCE | RXP4 
XCTL 
IGGOCLCF | EXTENDAA 


Figure 12 (Part 2 of 2). System Macros Used by CSECTs IGGOCLCC, 
IGGOCLCD, IGGOCLCE, and IGGOCLCF 












C 






Resource Enqueuing for CSECTS IGGOCLCC, IGGOCLCD, IGGOCLCE, and IGGOCLCF 


Three resources are used: high-level name, volume index, and 
volume index control entry (VICE). To prevent an interlock 
between two callers, the high-level name is always enqueued 
first, the volume index is enqueued second, and the VICE is 
enqueued last. 


The conditions of enqueuing are determined from the request. If 
the volume index is to be modified, then the volume index must 
be enqueued exclusively. requested, the high-level name is 

= chai exclusively to protect all lower-level indexes under 
it, 


The major name for enqueuing is always "SYSCTLG’. The minor 
name is one of the high-level names with the UCB Cunit control 
block) address appended to it. ‘'SYSCTLG’ with the UCB address 
appended to it, or zeros with the UCB address appended to it. 


Register Usage for CVOL Catalog Management 


With the exception of IGC0002H and IGGOCLF2, the CVOL catalog 
management CSECTs use a common set of registers. Subroutine 
IGGOCLCO initializes these registers, and their contents remain 
throughout. Contents of registers not described are considered 
destroyed. 


Register Meaning 


4 Base register for the CSECT 

6 Base register for WORKAREA DSECT 

8 Base register for CAMLSTD DSECT 

12 Linkage register for BAL instructions 
14 Linkage register for BAL instructions 
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CSECT/SUBROUTINE DESCRIPTIONS 3 
Each of the CSECTs of the CVOL processor and the subroutines of Jd 
CVOL catalog management are described in this section. 


Error~condition tests are not shown on the flowcharts. An error 

condition in CVOL catalog management results in a branch to 

label ERRxx, where xx is the appropriate error code. There, the 

error exception code is set, and a branch to IGGOCLCE?7 occurs. 

treeqaees on the flowchart are those used in the assembly 
isting. 
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CHART 1 (PART 1 OF 2). IGGOCLCA: FIRST INTERFACE MAPPER (CSECT IGGOCLCA 
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Notes for Chart 1 (Part 1 of 2) 
IGGOCLCA: First Interface Mapper 
IGGOCLCA is the entry point. Control 
ae from IGGOCLAL or IGGO002F via an 


Register Meaning 


10 Second base register for CSECT 
11 First base register for CSECT 
12 Base register for WORKCLCA 


data area 


FUNCTIONS: This CSECT is the entry and 
exit point for the CVOL processor. 

After ensuring that the PCCB is valid, 
IGGOCLCA determines what type of request 
has been sent to the CVOL processor and 
calls the appropriate subroutine. 


INTERNAL SUBROUTINES: For a list of 
internal subroutines used by IGGOCLCA, 
please see Figure 6 on page 18 in this 
chapter. 


EXITS: Control passes via a branch 
instruction to: 


e IGGOCLCB from subroutine GENLOC to 
process a VSAM generic locate. 


® IGGOCLCC for all other valid 
requests, 


ERROR CONDITIONS: For a list of error 
conditions, please see the lists of 
return codes under "CVOL Processor Exit 
and Output” on page 15 at the beginning 
of this chapter. 
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ART 2 (PART 1 OF ¢ GGOCLCB: SECOND INTERFACE MAPPER (CSECT IGGOCLCE ) 
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Notes for Chart 2 (Part 1 of 2) 
IGGOCLCB: Second Interface Mapper 


IGGOCLCB is the entry point. Control 
comes from subroutine GENLOC in the 
IGGOCLCA CSECT. 


Register Meaning 
11 Base register for CSECT 


12 Base Register for WORKCLCA 
data area 


FUNCTIONS: CSECT IGGOCLCB produces a 
list of data set names found cataloged 
under the requested high-level 
qualifiers. 


INTERNAL SUBRGUTINES: CIR provides an 
interface between IGGOCLCB and CVOL 
catalog management. 


POINTER updates the current entry 
pointer in the current block. 


EXITS: Control passes to IGGOCLCA via a 
branch instruction with a return code of 
zero in register 15. 

ERROR CONDITIONS: Control passes to 
IGGOCLCA via a branch instruction with 
one of the following return codes in 
register 15: 

Code Reason 

4 Data set (s) not found 


8 Insufficient storage or ESTAE 
macro failed 


12 User's work area too small 
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HART 3 (PART 1 OF 2) IGGOCLCO: 
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Notes for Chart 3 (Part 1 of 2) 
IGGOCLCC: Initialization 


IGGOCLCO is the entry point. Control 
comes from IGGOCLCA or IGGOCLCB. 


On entry, the registers are: 


Register Meaning 

1 Address of caller's parameter 
list CCAMLST) 

12 Address of Controller III work 
area 

13 Address of register save area 
within the Controller III work 
area 


On exit, the registers are: 


Register Meaning 

2 Address of UCB 

4 Base register for this 
subroutine 

5 Pointer to SVRB extension 

6 Base register for WORKAREA 
DSECT 

8 Base register for CAMLSTD 
DSECT 


9 Address of CVT 

12 Linkage register for BAL 
instructions 

13 Base register for BLDLAREA 

14 Linkage register for BAL 


instructions 


FUNCTIONS: WORKAREA is the common 
workspace and communications area for 
all CVOL catalog management subroutines. 
(Refer to "Data Areas" on page 92, for a 
description of WORKAREA.) When a locate 
function is requested, WORKAREA is built 
over the caller's 265-byte area, and the 
second area (called BLDLAREA) is 
obtained by GETMAIN. BLDLAREA is used 
with the routine IECPBLDL. 


When a nonlocate function ts requested, 
a larger srea is obtained by GETMAIN for 
WORKAREA. Part of this area ts used for 
BLDLAREA during execution of subroutines 
IGGOCLCQO, IGGOCLC1, and IGGOCLC2. The 
BLDLAREA portion of WORKAREA is 
redefined for use as input/output 
buffers thereafter. 


The first 256 bytes of WORKAREA are set 
to zero, which initializes all switches 
and flags. Supervisor addresses and the 
data set name go into WORKAREA, and the 
data set name is separated into its 
components. 
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Notes for Chart 3 (Part 2 of 2) 


BLDLAREA is initialized for use as 
input/output buffers. 


The UCB table is searched for device 
information about the given CVOL 
catalog. GETMAIN allocates space for a 
DCB and a DEB, and IGC0002H opens the 
CVOL catalog. 


Note: The OPEN macro instruction is not 
used to open a CVOL catalog. IGC0002H 
constructs a modified DCB/DEB for use by 
CVOL catalog management. No CLOSE macro 
is issued to close a CVOL catalog. 
FREEMAIN simply releases the main 
storage that is used for the modified 
DCB/DEB. 


The first component of the data set name 
is used as the search parameter for 
BLDL. Searching begins with the first 
block of the CVOL catalog. If BLDL 
returns a CVOL pointer entry, an error 
return code is returned to the user. 


INTERNAL SUBROUTINES: None. 


EXITS: Control passes via a branch 
instruction to: 


@ IGGOCLC1] if the requested function 
is BLDA or LNKX, 


e LNKX or if the high-level name is an 
alias. 


e IGGOCLC?7 for an error condition. 


e IGGOCLC2 for all other functions or 
conditions. 


Control passes via a branch to IGC0002H 
to open the CVOL catalog and returns to 
this subroutine. 

ERROR CONDITIONS 

Code Reason 


4 Volume not mounted or does not 
contain the CVOL catalog. 


20 Syntax error in data set name. 
24 Permanent input/output error. 
28 Bad relative track address for 


the CVOL catalog. 
32 Bad address for caller's area. 


REFERENCES: CVT, TCB, SVRB, DCB, DEB, 
and UCB are described in Data Areas. 
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Notes for Chart 4 (Part 1 of 2) 
IGGOCLC1: Relative GDG and Alias 


IGGOCLC! is the entry point. Control 
comes from: 


e IGGOCLCO when the requested function 
is either BLDA or LNKX, 
locate-by-block, or when an alias is 
found Cexcept with a DLTA request). 


e IGGOCLC2 when a relative GDG number 
is found in the data set name. 


Register Meaning 

4 Base register for this 
subroutine 

6 Base register for WORKAREA 
DSECT 

& Base register for CAMLSTD 
DSECT 

12 Linkage register for BAL 
Instructions 

13 Base register for BLDLAREA 

14 Linkage register for BAL 


instructions 


FUNCTIONS: When locate-by-block is 
requested, the block is read and 
returned to the caller. 


When control comes from IGGOCLC2, 
control goes to label RELGDG for 
relative GDG processing. 


If the requested function is BLDA or 
LNKX, the appropriate entry is 
constructed and control passes to 
IGGOCLC2 to the update subroutines. 


When an alias 1s discovered, the fully 
qualified name is reconstructed in the 
caller's name area, using the true name. 
The name table is updated to reflect the 
change, and the high-level name is 
re-enqueued. 


Control comes from IGGOCLC2 when a 
relative GDG number is discovered in the 
data set name. This subroutine 
determines the absolute GDG name for the 
data set. If the request is a locate 
function, either the volume list for the 
data set or a new absolute GDG name is 
returned to the caller. Otherwise, an 
error condition exists and IGGOCLC?7 is 
invoked. 


The generation number in absolute GDG 
names 1s complemented before the names 
are added to the generation index. 
Therefore, the most recent entry (the 
highest generation number) is the first 
entry in the index, the second most 
recent entry is the second entry in the 
index, etc. 
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Notes for Chart 4 (Part 2 of 2) 


When the relative GDG number is negative 
or zero, an absolute GDG name from the 
generation index is returned to the 
caller along with the corresponding 
volume list. Zero corresponds to the 
first entry, —1 corresponds to the 
second entry, and so forth. 


When the relative GDG number i5 
positive, a new absolute GDG name is 
created and returned to the caller. If 
the generation index is empty, this name 
is GOO0O0nV00 (where n is the relative 
number). If the generation index is not 
empty, the relative GDG number is added 
to the generation number of the first 
entry to create the new absolute GDG 
name. 


INTERNAL SUBROUTINES: CALLBLDL calls 
BLDL routine via entry point IECPBLDL. 


EXITS: Control passes via a branch 
instruction to: 


e IGGOCLCA or IGGOCLCB after relative 
GDG processing. 


e IGGOCLC?7 for error conditions. 


° IGGOCiLC2 for all other functions or 
conditions. 


ERROR CONDITIONS 

Code Reason 

8 Name not found for locate 
function, or existing structure 
inconsistent with request for 
non-locate function. 


20 Syntax error in data set name. 


28 Permanent I/0 error. 
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CHART 5 (PART 1 OF 2), IGGOCLC2: LOCATE (CSECT IGGOCLCC 
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Notes for Chart 5 (Part 1 of 2) 


IGGOCLC2: Locate 

IGGOCLC2 is the entry point. Control 
comes from: 

e IGGOCLC!L after resolving an alias or 


constructing an entry for BLDA or 


LNKX request. 


e IGGOCLCO for all other functtons or 


conditions. 


Register 
4G 


12 


13 
14 


Meaning 


Base register for this 
subroutine 


Base register for WORKAREA 
DSECT 


Base register for CAMLSTD 
DSECT 


Linkage register for BALR 
instructions 


Base register for BLDLAREA 


Linkage register for BALR 
instructions 


FUNCTIONS: This subroutine completes the 
locate functions, or finds the last 
valid index level for a non-locate 
function. IECPBLDL (BLDL) is used to 
search index levels successively. At 
each index level, one component of the 
data set name 15 used. When 
locate-by-name 1s requested, BLDL is 
used with each component of the data set 
name as the search parameter. When BLDL 
returns an index pointer entry CIPE), 
IGGOCLC2 uses it to determine the track 
address for the next search. The search 
by BLDL continues with the next 
component of the name. 


When BLDL returns a data set pointer 
entry (CDSPE) or volume control block 
pointer entry (VCBPE), the corresponding 
volume list 1s returned to the caller. 


When the request 1s for a non~locate 
functton and BLDL fails to find the next 
level, the update process is initiated. 


The last valid level of the existing 
index structure 18S saved to use while 
updating. 


IGGOCLC2 contains skeletal channel 
programs that are used by the nonlocate 
subroutines. These CCW chains are moved 
to BLDLAREA. 
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Notes for Chart 5 (Part 2 of 2) 


INTERNAL SUBROUTINES: UCATDX maintains a 
TTR trail of blocks that can be deleted. 


BLDLCALL calls BLDL to search for one 
name. 


TORLTV converts an absolute address to a 
relative track address. 


NEXTLVL gets the component of the data 
set name in order to search for the next 
level. 


RECHK performs RACF authorization 
checking. 


EXITS: When the request is a locate 
function, control passes to: 


e IGGOCLCA or IGGOCLCB along with the 
volume list for the data set name. 


e IGGOCLC!L for relative GDG number. 


When the request is for a nonlocate 
function, control passes to: 


e IGGOCLC7 for an error condition. 


e IGGOCLCS for all other functions or 
conditions. 


ERROR CONDITIONS 
Code Reason 


8 Name not found for locate 
request, existing structure 
inconsistent with non-locate 
request, or the last entry found 
was a CVPE with locate request. 


12 Last entry found was an IPE or 
alias with locate request. 

16 Nonexistent index levels 
specified. 

20 Syntax error in data set name. 

28 Permanent I/0 error. 
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Notes for Chart 6 (Part 1 of 2) 
TECPBLDL 


IECPBLDL is the entry point. Control 
comes from IGGOCLCL or IGGOCLC2. 


Register Meaning 


0 BLDL List address 

1 DCB address 

13 400 byte WORKAREA address 
14 Return address 


FUNCTIONS: This subroutine searches the 
CVOL catalog for a name, and returns the 
information stored in the directory 
associated with each name. The format 
of the directory and of the returned 


information is described in Syste 
Programmin ibrary: 


Services. 


EXITS: Control returns to the caller via 
a branch instruction when IECPBLDL 
completes its function. 


= 


Data Managemen: 


Control returns to the caller via a 
branch instruction for an error 
condition. 

INTERNAL SUBROUTINES: None. 

ERROR CONDITIONS 

Code Reason 

4 Entry not found 


8 Permanent I/0 error 
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Notes for Chart 7 (Part 1 of 2) 


IGGOCLC3: Update Initialization and 
Entry Butlding 


IGGOCLC3 is the entry point. Control 
comes from: 


e IGGOCLC4 after constructing a DSPE 
for a CATBX request. 


e IGGOCLC5 after writing a volume 
control block and constructing a 
VCBPE for a CATBX function. 


e IGGOCLC2 for all other functions or 
conditions. 


Register Meaning 


4 Base register for this 
subroutine 

6 Base register for WORKAREA 
DSECT 

8 Base register for CAMLSTD 
DSECT 

12 Linkage register for BAL 


instructions 


14 Linkage register for BAL 
instructions 


FUNCTIONS: When entry is from IGGOCLC4 
or IGGOCLC5, index levels for a CATBX 
request must be built. Control goes to 
label CATBX on the next subchart. 


When control comes from IGGOCLC2, the 
index control entry CICE), if not 
already present, and volume index 
control entry (VICE) are read. The 
request is checked against available 
space in the CVOL catalog it ensure that 
there is enough space to make the 
required changes. 


This module constructs new index levels 
for a CATBX function and constructs an 
index pointer entry for the new level to 
be added to the existing structure. 

When the requested function is DRPX or 
DLTA, the entry to be removed is named 
and IGGOCLC6 deletes it. 


When CATBX is requested, IGGOCLC4 is 
called to construct the DSPE. Control 
returns to IGGOCLC3 where the required 
index levels are built and written into 
the CVOL catalog. Each level results in 
an index pointer entry CIPE) that must 
be added to the next higher level. When 
an existing level is reached, control 
passes to IGGOCLC6. 


IGGOCLC3 routes the update request to 


the subroutines that perform the 
appropriate function. 
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Notes for Chart 7 (Part 2 of 2) 


INTERNAL SUBROUTINES: MOVELVL gets the 
component of the data set name for the 
current index level from name table. 


WRISRCH writes a new block to the CVOL 
catalog and searches for another 
available block. 


KEYICE constructs a new index block, 
with its ICE and key. 


TOABSL converts a relative track address 
to an absolute track address. 


TORLTV converts an absolute track 
address to a relative track address. 


I01 performs EXCP input/output. This 
subroutine invokes IGCO0002H if a new 
extent of the CVOL catalog is required. 


EXITS: Control passes via a branch 
instruction to: 


6 IGGOCLC4 when the requested function 
18s CATBX, CAT, RECAT, or UNCAT. 


6 IGGOCLC5 when blocks of the CVOL 
catalog need to be freed, or when 


new blocks have been written, but 
the requested process has been 
aborted. 


° IGGOCLC7 for error conditions. 


® IGGOCLC6 for all other functions or 
conditions. 


Control passes via a branch to IGC0002H 
when a new extent of the CVOL catalog is 
required or when the CVOL catalog must 
be reopened, and returns to this 
subroutine. 


ERROR CONDITIONS 

Code Reason 

8 Existing structure is 
inconsistent with the requested 
function. 


12 Attempt to delete a nonempty 
index level. 


20 Not enough space available in the 
CVOL catalog to perform the 
requested function. 


28 Permanent I/0 error. 
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Notes for Chart 8 (Part 1 of 2) 
IGGOCLC4: Entry Building 

IGGOCLC4¢ is the entry point. Control 


comes from IGGOCLC3 when the requested 
function 1s CAT, CATBX, RECAT, or UNCAT. 


Register Meaning 

4 Base register for this 
subroutine 

6 Base register for WORKAREA 
DSECT 

8 Base register for CAMLSTD 
DSECT 

12 Linkage register for BAL 
instructions 

14 Linkage register for BAL 


instructions 


FUNCTIONS: If the requested function is 
RECAT or UNCAT, control passes to label 
ALTERTN. If the request is for CAT or 
CATBX, control passes to label CATRTN. 


This subroutine constructs a new DSPE or 
VCBPE. When there are more than five 
volumes in the volume list, IGGOCLC5 is 
invoked to write volume control blocks. 


If the data set name is not for a 
generation data group, control passes to 
label CULMINAT. Part two of the 
flowchart deals with cataloging 
functions to a generation index. The 
new member of a GDG is checked against 
existing members to see if this is a new 
version of an existing member. 


If the maximum number of entries that a 
generation index can hold is exceeded 
with this addition, the EMPTY and DELETE 
options for GDG are processed. 


If EMPTY was specified, IGGOCLC5 will 
remove all entries from the generation 
index before adding the new entry. 
Otherwise, IGGOCLC5 will remove only the 
oldest entry before adding the new 
entry. IGGOCLC4 flags what is to be 
done. 


If DELETE was specified, IGGOCLC4 issues 
the SCRATCH macro instruction on every 
data set name that will be removed by 
IGGOCLC5. If DELETE is not specified, 
nothing is scratched. 


The RECAT and UNCAT functions are 
processed by naming the old entry. 
IGGOCLC6 deletes the old entry when it 
gets control. For RECAT, a new entry is 
also constructed. IGGOCLC6 adds this 
new entry to the CVOL catalog. 
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Notes for Chart 8 (Part 2 of 2) 


INTERNAL SUBROUTINES: TOABSL2 converts 
an absolute track address to a relative 
track address. 


I02 performs EXCP input/output 
operations. 


GET reads a block from the CVOL catalog 
into the input buffer of BLDLAREA. 


SETUP points to the first and last entry 
in an index block. 


INCR bumps the pointer to the next entry 
in an index block. 


BLDENTRY constructs a data set pointer 
entry (DSPE) or a volume control block 
pointer entry (CVCBPE). 


SCRATCH performs a SCRATCH macro 
instruction for one data set and its 
CBs. 


EXITS: Control is passed via a branch 
instruction to: 


6 IGGOCLC3 when CATBX is being 
performed. 


° IGGOCLC5 when auxiliary reading or 
writing 18 required: 


> Volume control blocks (VCBs) 
need to be written. 


~ VCBs or index blocks need to be 
freed. 


- The DELETE option of a GDG needs 
to be performed. 


_ Updated GDG index blocks need to 
be rewritten. 


e IGGOCLC? for error conditions. 


° IGGOCLC6 for all other functions or 
conditions. 


ERROR CONDITIONS 


Code Reason 


8 Existing structure is 
Inconsistent with requested 
function. 

16 Nonexistent index level required. 

24 Improperly named GDG data set, or 


GDG data set to be added is older 
than existing GDG data sets. 


28 Permanent I/0 error. 
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Notes for Chart 9 (Part 1 of 2) 
IGGOCLCS: First Load of Update 
IGGOCLCS is the entry point. Control 
comes from IGGOCLC3 or IGGOCLCS when 
blocks of the CVOL catalog need to be 
written or freed. 


Register Meaning 


4 Base register for this 
subroutine 

6 Base register for WORKAREA 
DSECT 

8 Base register for CAMLSTD 
DSECT 

12 Linkage register for BAL 


instructions 


14 Linkage register for BAL 
instructions 


FUNCTIONS: ENQ is reissued to ensure 
that any changes to the CVOL catalog 
will be completed. 


This subroutine consists of a series of 
tests for required functions. Each test 
calls the appropriate internal 
subroutine to perform one function if it 
1s required. 


Chains of volume control blocks (VCBs) 
and index blocks are freed if possible; 
that is, they are set to zeros and 
rewritten into the CVOL catalog. They 
then have a key of zero, indicating that 
they are available for use. 


If changes have been made to a 
generation index, the block containing 
the generation index pointer entry 
(GIPE) must be updated. Likewise, the 
last block of the generation index may 
need to be rewritten. 


If a generation index reached its 
maximum number of entries in IGGOCLCS4 
and the EMPTY option was specified, that 
option 1s processed. IGGOCLC4 will have 
already processed the DELETE option. 


If the generation index if full and the 
EMPTY option was not specified, the name 
with the lowest generation number (the 
oldest data set) is removed from the 
index. 


An UCATDX request can result in unneeded 
index blocks. Such blocks are freed. 


If a CATBX function is requested and the 
volume list contains more than five 
volumes, volume control blocks are 
constructed from that list and written 
to the CVOL catalog. 
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Notes for Chart 9 (Part 2 of 2) 


INTERNAL SUBROUTINES: WRBLKRTN, 
WRLSTRTN, EMPTYRTN, FRNDXRTN, FRVCBRTN, 
FRBLKRTN, and BLVCBRITN are shown on the 
flowchart. 


SETUP points to the first and last entry 
in an index block. 


INCR increments the pointer to the next 
entry in an tndex block. 


TOABSL converts a relative track address 
to an absolute track address. 


TORLTV converts an absolute track 
address to a relative track address. 


T03 performs EXCP input/output 
operations. This subroutine invokes 
IGCO002H if a new extent ts required. 


EXITS: Control passes via a branch 
Instruction to: 


e IGGOCLC3 when the requested function 
is CATBX. 


e IGGOCLC?7 for error conditions. 


e IGGOCLC6 for all other functions or 
conditions. 


Control passes via a branch to IGC0002H 

when a new extent of the CVOL catalog is 

required, and returns to this 

subroutine. 

ERROR CONDITIONS 

Code Reason 

20 Not enough space available in the 
CVOL catalog to perform the 
requested function. 


28 Permanent I/0 error. 
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Notes for Chart 10 (Part 1 of 2) phases, and propagates (ripples) the 
change through the index chain as 
IGGOCLC6: Second Load of Update needed. Each entry is taken from the 
buffer INPUT and placed into the buffer 
IGGOCLC6 is the entry point. Control OUTPUT until the collating sequence of 
comes from: the entry 18S equal to or greater than 
the name itn the update request. If the 
e IGGOCLC4 when the requested function request name is equal, that entry is 
1s CAT, UNCAT, RECAT, or CATBX. skipped (delete function). If the 
request name is greater, the new entry 
e IGGOCLC3 or IGGOCLCS5 for all other is merged into OUTPUT Cadd function). 
requests or conditions. Overflow entries become an add request 


for the next block in the chain. 
Register Meaning 
Subroutines named GET and PUT are used 


4 Base register for this for input/output. GET reads a block 
subroutine into INPUT, a field of WORKAREA, and 
initializes PUT. Entries are 
6 Base register for WORKAREA transferred from INPUT to OUTPUT, 
DSECT another field of WORKAREA. When all 
entries have been exhausted from INPUT, 
8 Base register for CAMLSTD another block of the index 15 read from 
DSECT SYSCTLG. 
12 Linkage register for BAL When OUTPUT is full, a block is written 
Instructions to SYSCTLG from OUTPUT by the routine 
PUT. PUT checks all available records 
14 Linkage register for BAL before writing the block and chooses the 
Instructions record of SYSCTLG that is most likely to 
result in contiguous blocks of one 
FUNCTIONS: This subroutine adds or index. PUT tries to free any unneeded 
deletes an entry to or from a given blocks; any unneeded block that PUT 
index block, as set up by earlier cannot free 1s later freed by GET. 
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Notes for Chart 10 (Part 2 of 2) 


INTERNAL SUBROUTINES: GET reads one 
block from an index in the CVOL catalog. 


PUT prepares and writes one block into 
an index in the CVOL catalog. 


TOABSL converts a relative track address 
to an absolute track address. 


TORLTV converts an absolute track 
address to a relative track address. 


I01 performs EXCP I/0 operations. 


EXITS: Control is always passed to 
IGGOCLC7 via a branch instruction. 


ERROR CONDITIONS: The only exception 
code from this subroutine is 28 (1C), 
which indicates that a permanent 
input/output error has occurred. 
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Notes for Chart 11 (Part 1 of 2) 


IGGOCLC7: Third Load of Update and Error 
Handling 


IGGOCLC?7 is the entry point. Control 
normally comes from IGGOCLC6, but can 
come from any subroutine of CVOL catalog 
management when an error condition 1s 
discovered. 


Register Meaning 

4 Base register for this 
subroutine 

5 Pointer to SVRB extension 

6 Base register for WORKAREA 
DSECT 

8 Base register for CAMLSTD 
DSECT 

12 Linkage register for BAL 
Instructions 

14 Linkage register for BAL 


Instructions 


On exit, all registers (except registers 
0, 1, and 15) are restored by the 
supervisor. 


Register 15 contains the exceptional 
return code. Registers 0 and 1 contain 
additional information that specifies 
the type of error encountered. 


FUNCTIONS: IGGOCLC7 completes the update 
process. The last block of an updated 
index is written to the CVOL catalog. 


The block containing the index control 
entry CICE) is read, and the ICE is 
updated to reflect changes to the index. 
This block is rewritten to the CVOL 
catalog. 


The block containing the volume index 
control entry (VICE) is read, and the 
VICE 1s updated to reflect changes to 
the CVOL catalog. This block is 
rewritten tnto the CVOL catalog. 


Tests are made before rewriting any 
block. If the block is both the last 
block of an index and the block 
containing the ICE, or the block 
containing the VICE, it is rewritten 
only once. 


If an error is discovered, pertinent 
information is gathered from the 
WORKAREA and placed into an environment 
record and written to the CVOL catalog. 
If the error 1s a sequence error, 
message JEC30461 is written to the 
operator console. If the error is an 
I/O error on a non-locate operation, 
message JEC302I is written to the 
operator console. The exceptional 
return code is set and all resources are 
freed. Control returns to the caller of 
CVOL catalog management via a branch 
Instruction. 
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Notes for Chart 11 (Part 2 of 2) 


INTERNAL SUBROUTINES: READ reads one 
block from the CVOL catalog. 


WRITE writes one block to the CVOL 
catalog. 


TOABSL converts a relative track address 
to an absolute track address. 


TORLTV converts an absolute track 
address to a relative track address. 


I02 performs EXCP tnput/output 
operations. This subroutine invokes 
IGCO002H if a new extent of the CVOL 
catalog is required. 


ERROR CONDITIONS: This subroutine 
returns any exception code from another 
CVOL catalog management CSECT to the 
caller. This exception code is passed 
to IGGOCLC?7 in WORKAREA. 


The only exception code from this 
subroutine is 28, which indicates that a 
permanent I/0 error has occurred. 


EXITS: IGGO002H may be invoked via a 
branch when a new extent of the CVOL 
catalog is required. Control returns to 
this subroutine when a new extent has 
been located. 


Control returns to IGGOCLCA or IGGOCLCB 
via a branch instruction. 
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Notes for Chart 12 (Part 1 of 2) 
IGCOO002H: SYSCTLG Open/Extend 


IGCO002H is the entry point. 
comes from: 


° IGGOCLCO or IGGOCLC3 to open a CVOL 
catalog. 


° IGGOCLC3, IGGOCLC5, or IGGOCLC7 to 
extend the CVOL catalog. 


Control 


° Control also comes via an XCTL macro 
instruction from IGGO553E after 
extending SYSCTLG. 


On entry for opening, the registers are: 


Register Meaning 

0 Zero 

1 Address of UCB for volume 

8 Address of CAMLST 

15 Address of area tn which to 


build DCB/DEB chain 


On entry for extending, the registers 
are: 


Register Meaning 

0 Address of DCB for the CVOL 
catalog 

8 Address of CAMLST 


On entry after extending, the registers 
are: 


Register Meaning 


6 Address of SVRB 

7 Address of Extend Work Area 
8 Zero 

9 Address of catalog DCB 

10 UCB address 


On exit, the register is: 
Meaning 
1 Address of DCB/DEB chain 


FUNCTIONS: When this subroutine is 
entered to open a CVOL catalog, a data 
control block (DCB) and a data extent 
block (DEB) are built in the work area 
provided by IGGOCLCO. If the catalog is 
new, IGGOCLF2 is tnvoked to format it. 


Note: The DCB/DEB constructed by this 
subroutine is a modification of that 
described in Debugging Handbook. These 
two blocks are merged together; that is, 
they overlap in the same area of main 
Sacre as shown in Figure 13 on page 
8. 


Register 


For SYSCTLG data sets that reside on MSS 
virtual volumes, an acquire for DASD 
space is Issued. 
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CHART 12 (PART 2 OF 2). I1GC0002H: SCTLG OPEN/ END (CSECT IGGOCLCF 
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Notes for Chart 12 (Part 2 of 2) 


When this subroutine is entered to cross 
to another extent of the CVOL catalog, a 
test 1s made to see if another extent 
already exists. If so, WORKAREA is 
modified accordingly, and control 
returns to the caller. 


When another extent does not exist, the 
virtual storage for the previous DCB/DEB 
is released and a new area is obtained 
with GETMAIN. IGG0553A is invoked to 
allocate a new extent and a new DCB/DEB 
is built tnto the new area (the catalog 
is reopened). 


Main storage for the DCB/DEB is set to 
zeros before building; then only the 
fields that are shown are filled tn. 
The DEB overlays the DCB at offset 40 
(28). The fields that are named are 


described in Debugging Handbook. 


INTERNAL SUBROUTINES: GETMAIN gets main 
storage for the DCB/DEB. 


I0 performs EXCP input/output 
operations. 


EXITS: Control returns to the caller via 
a branch instruction when IGC002H 
completes its function. 


Control returns to the caller via a 
branch instruction for an error 
condition. 


Control passes via XCTL to IGGO553A when 
another extent ts required. Control 
returns via XCTL to entry point 
IGCO002H. 

Control passes via a branch instruction 
to IGGOCLF2 when either the CVOL catalog 
or a new extent needs to be formatted. 
Control returns directly to the caller. 
ERROR CONDITIONS 

Code Reason 


4 No extents are allocated or 
acquired. 


8 No more extents are available. 


12 Permanent I/O error. 
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Notes for Chart 13 (Part 1 of 2) 


IGGOCLFe: 
IGGOCLF2 is the entry point. 


SYSCTLG Formatter 
Control 


comes from IGCO0002H. 


Register 
0 


Meaning 


Contains zeros when formatting 
the CVOL catalog 


Address of DCB for this data 
set 


Number of blocks per track for 
this device 


Number of bytes in work area 
passed to IGGOCLF2 


Data management count 
decrement value 


1974,1982 


6 Starting relative track 
address CTTR) when formatting 
the CVOL catalog 


7 Address of work area 


FUNCTIONS: The data set is formatted 
into 256-byte blocks with 8-byte keys. 


If the extent is being formatted during 
an open CVOL catalog request, this is 
the first extent of a new CVOL catalog. 
The first block is tnitialized by 
writing a volume index control entry 
(VICE) into it. 


If formatting is not being done for the 
first extent, this is a new extent of an 
already existing CVOL catalog. The VICE 
is read, updated, and rewritten to 
reflect the new extent. 


The work area that is passed to IGGOCLF2 
is freed before exit. 
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Notes for Chart 13 (Part 2 of 2) 
INTERNAL SUBROUTINES: CNVT converts a 
relative track address to an absolute 
track address. 


I0 performs EXCP input/output 
operations. 


RELOC builds channel programs for 
input/output. 


ERROR CONDITIONS: IGGOCLF2 returns on 
exception code, 12 (hex), which 
indicates that an I/0 error has 
occurred. 


EXITS: Control is returned to the caller 
of IGCO002H via a branch instruction. 
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MICROFICHE DIRECTORY 





This chapter contains a listing of the CSECTs that make up the 
CVOL processor and the subroutines contained within each CSECT. 
These listings are helpful in summarizing program organization. 


Note: The listings use CPL, FVT, and FPL instead of CTGPL, 


CTGFV, and CTGFL, respectively. See Catalog Diagnosis Reference 
for a description of these data areas. 


In the following tables, the CSECT name appears in the first 
Cleftmost) column. The second column contains an entry-point 


label or a subroutine label Cinternal procedure). The third 
column differentiates between entry points (CEP) and procedures 
CPR). The fourth column describes the subroutine. For more 


information on the CSECTs and subroutines, refer to "Method of 
Operation" on page 4, and "Program Organization" on page 13. 
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( CSECT Subroutine | Use Description 
IGGOCLCA : CVOL Sharing Interface Mapper CSECT 1. 


This module is the first of two CSECTs 


that map VSAM and 05S catalog functions 
to CVOL Catalog Management. 


IGGOCLCA | EP | Main entky eoint for this CSECT: 
IGGOCLIA —_ Dynamically allocates a CVOL Catalog. 


DELETE Processes a VSAM-like delate request. 
This is accomplished by tssuing an OS 
UCATDX request and optionally a 
SCRATCH SVC. 


a Ce Precesses a ‘'DSCBTTR’ CTGFL. 
| pstyPNam =| PR Processes a 'DSTYPNAM’ CTGFL. 
. | ENTNAME = | PR Processes a 'ENTNAME’ CTGFL. 
J ENTYPE =| PR Processes a ‘'ENTYPE’ CTGFL. 
ori Processes a 'ESTAE’ intercepted abend. 


FPLMV Processes the following repeating 
field CTGFLs: DEVTYP, VOLSER, FILESEQ, 
| and CATVOL. 
GENLOC Processes a VSAM-like generic locate. 
Most of the processing is done by the 
' second CSECT of the Interface Mapper 
CIGGOCLCB). 


‘ ae | Changes storage key via MODESET macro 
from user key to SVC key. 


halal Changes storage key via MODESET macro 
from SVC key to user key. 

LOCNAME | PR Issues an OS LOCATE by NAME request. 

LOCTTR PR | Issues an OS LOCATE by TTR request. 


OSREQ Sets up and executes an original OS 
CAMLST format request. 

RESCAN | Searches the CVOL Catalog and 

| determines if the specified data set 

15 a generation data group type. 
If a generation index pointer entry 
(GIPE) ts found, the GIPEPTR contains 
the address of the GIPE. Otherwise, 


the GIPEPTR contains zeros to indicate 
the absence of a GIPE. 


SLDGD Processes a SUPERLOCATE generation 
data group request with the base 


generatton number supplied. 


SLGDGB Processes a SUPERLOCATE generation 
data group request to return the 
| generation data group base value. 
SLGDGBL Searches for a new absolute generation 
number if the supplied relative 
generation number its less than zero. 
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IGGOCLCA a Processes a normal superlocate request 
or a GDG ALL request. 
banal hi Fills the user's volume list area with 
volume serial numbers, device types; 
and file sequence numbers. 


SRCHPCCB Searches the PCCB (Private Catalog 
Control Block) chain to see if a PCCB 
for the needed catalog is already on 

the chain. If it ts, the PCCBPTR 
points to it. If there is no PCCB, tha 
PCCBPTR is zeroed. 

SUPERLOC Determines type of superlocate request 
and calls the appropriate procedure: 
SLGDG, base generation number 
supplied; SLGDGB, base only requested; 
or SLNAME, normal SUPERLOCATE. 


VLOC Processes a VSAM LOCATE or an Access 
Method Services LISTCAT. 


IGGOCLCB This is the main processing module for 
the Generic Locate. It searches the 
SYSCTLG data set using CVOL Catalog 
Management LOCATE and returns the 
names of all data sets that are found 
to have the requested high level 
qualifiers as the first part of the 
data set name. 


IGGOCLCB EP Only entry point for this CSECT. 
CIR CIR locates and builds the lists of 
qualifiers to be processed for CSECT 
IGGOCLB. 
CODEO0 This subroutine gets control if LOCATE 
passes a return code of zero. 


DSNAMRT This subroutine gets control when a 
data set entry is found in the list 
from CIR. DSNAMRT checks to determine 
if a generation data group 1s being 
processed. If so, the generation 
portion of the simple name must be 
complemented. 


GDGROUT This subroutine is entered if a 
generation data group entry 1s found 
in the CIR list. It turns on the GDGSW 
switch so that the data set name entry 
routine CDSNAMRT) will know that the 
generation number in the simple name 
will not need complementing. A check 
1s made to see if any generations 
exist. If not, this entry is skipped. 
If any generations exist, the count of 
the number of generations cataloged is 
kept and decremented each time a 
generation name is processed. Control 

| 15 passed to the index entry routine 
CINDEXRT) to read in the list of names 
through CIR. Register 6 points to the 
current entry. 
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csect | subroutine | use” Description 


IGGOCLCB INDEXRT This subroutine gets control when an 
index entry is discovered in the list 
from CIR. It sets up a parameter list 
for CIR and uses subroutine OBTBLK to 
allocate another block for a new list 
of lower qualifiers. The new list is 
made current, and CURNTBLK points to 
the current CIR list. 


MAINOO This subroutine checks for a null list 
and returns to the caller with a 
return code of 4 if the index 
structure specified or the USERID had 
no data sets cataloged under it. 


Entry is made to this subroutine with 
register 6 potnting to a new list 
element or entry. The list entry is 
analyzed and the appropriate routine 
1s used to process it. Data set name 
entries are used to complete fully 
qualified data set names, and are 
returned in the caller's output area. 


OBTBLK This subroutine is used to obtain a 
new block to be used as a work area 
for CIR and to become the current 
block. If no free blocks are 
available, a conditional GETMAIN is 
issued and the new block is added on 
the chain. If the GETMAIN fails, 
control is returned to caller with a 
return code of 8. 


Cc POINTER This subroutine updates the current 
entry pointer in the current block. 
The current block is determined by 
searching the chain for the first 
block with a zero entry pointer and 
then backing up one. The current entry 
type is determined, and the pointer is 
advanced accordingly. If the next 
entry is a link entry Which contains a 
nonzero TTR, the CIR is called to 
provide the next block of entries. If 
the TTR is zero, the current block is 
released and the preceding block 15 
considered. When all blocks are 
processed, that is, the current block 

: equals the first block and the empty 
block equals zero, the WRAPUP routine 


1s entered. 





VCBROUT This subroutine 1s given control when 
a volume control block (VCB) entry is 
found in the list from CIR. A check is 
made to determine if a generation data 
group is being processed. If so, the 
generation portion of the simple name 
must be complemented. If there is no 
generation data group, the simple name 
1s not complemented. 

WRAPUP This subroutine gets control when 
processing for IGGOCLCB is completed 


or an error resulting in termination 
occurs. It frees all the dynamic core 
obtained for IGGOCLCB. 
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IGGOCLCC CSECT IGGSCLCC performs the read 
operation for CVOL Catalog Management. 
It performs the locate functions and 
the locating part of the nonlocate 
functions. 


IGGOCLCC ied Only entry point for CSECT TGGOCLCC. 


IGGOCLCO 


IGGOCLC] | 
| IGGOCLC2 


TECBLDL taal 









This subroutine initializes the work 
areas, opens the given CVOL Catalog, 
and searches for high level names. 






This subroutine resoives aliases, 
constructs BLDA or LNKX entries,» and 
processes relative generation data 
groups. 







This subroutine searches lower levels 
of the name, saves last valid index 

levels, and relocates CCWs for use by 
CSECTs IGGOCLCD and IGGOCLCE. 











This subroutine searches for the 
qualified name tn the CVOL Catalog. 





Performs RACF authorization checking 
RACHK via RECHECK macro for UNCATLG, 
| RECATLG, DRPX, and CATLG-GDG requests. 


IGGOCLCD | t CSECT IGGOCLCD performs the setup 
operation. It checks the validity of 
the requests against the existing 
entries in the CVOL Catalog. It builds 
new entries to be added to the 
catalog, or it names entries to be 


| | deleted. 
| IGGOCLCD PEP Only entry point for CSECT IGGOCLCD. 
IGGOCLC3 ; PR | This subroutine ensures that VICE, 


ICE, and space are present. It 

constructs and writes mew index | 
blocks, and routes nonlocate 
requests. | 





IGGOCLC4 | PR This subroutine constructs new DSPEs 
or VCBPEs. It scratches generation 
data groups if requested. The EMPTY 
option for generation data groups 
allows the the existing generations to | 
be scratched before adding new ones. 





IGGOCLCS5 ; | This subroutine frees index blocks, 
frees volume control blocks, and 
writes new volume control biocks. [t 
also performs the EMPTY option as 
requested. 
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This subroutine writes the last 
updated block, updates the control 
entries, returns control to CSECT 
IGGOCLCA or IGGOCLCB, Whichever called 
CSECT IGGOCLCC. This subroutine also 
handles all error conditions for 
CSECTs IGGOCLCC, IGGOCLCD, and 
IGGOCLCE. 
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IGGOCLCE CSECT IGGOCLCE performs the write 
operation. It merges entries into 
that is needed 

I6GoCLCE | EP | Only entry point for CSECT IGGOCLCE. | 

a change as needed to the last block 
of the updated chain. 

IGGOCLCF 
CVOLs, and formats new extents. 

IGGOCLCF EP Main entry point for CSECT IGGOCLCF. 


LY26~-3895-0 

SYSCTLG blocks, deletes entries from 

IGGOCLC6 This subroutine updates blocks, writes 
CSECT IGGOCLCF performs three 

IGC0002H This subroutine opens the SYSCTLG data 
set and gets the next extent of that 
data set. For SYSCTLG data sets which 
reside on MSS virtual volumes, it 
acquires the DASD space using SVC 26. 


CSECT Subroutine | Use Description 
blocks, and does most of the writing 
updated blocks to SYSCTLG, and ripples 
IGGOCLC7 7 
functions: it opens CVOLs, extends 
IGGOCLF2 This subroutine formats new extents of 
a catalog. 
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DATA AREAS 





The data areas and record formats in this chapter are described 
in four columns, which are interpreted as follows: 


e offset 
The numeric address of the field relative to the beginning 
of the area. The first number is the offset in decimal, 
followed Cin parentheses) by the hexadecimal equivalent. 

e Bytes and Alignment 


The size (number of bytes) of the field and its alignment 
relative to the fullword boundary. 


Examples: 
4 A 4-byte field beginning on a word boundary. 
=e) A 3-byte field beginning on a halfword boundary and 


running into the next word. 


2 A 2-byte field beginning at the low-order byte of a 
word and running into the next word. 


e Name and Content 


A name that identifies the field. This name appears as a 
label in the assembly listings. 


This column is also used to show the contents of the field 
or the bit settings of flag fields (the state of bits in a 
byte). When the column is used to show the state of the 
bits €0 or 1) in a flag byte, it is shown as follows: 





The 8 bit positions (0-7) in a byte. For ease 
of scanning, the high-order Cleftmost) 4 bits 
are separated from the low-order 4 bits. 


Sie A hss A reference to bit 0. 
Ne ee Bit 0 is on. 
Dee Santee Bit 0 is off. 


xx A reference to bits 6 and 7. 
Bit settings that are significant are shown and described. 
Bit settings that are not presently shown are understood to 
be reserved bits. 
e Field Description and Meaning 


The use of the field. 


SYSCTLG ENTRY FORMATS 
This section describes the formats of the entries of SYSCTLG, 
along with the symbolic labels that are used to refer to their 
fields. The entries are arranged alphabetically. 


Except for the volume control block (VCB), SYSCTLG entries have 





a similar format. These entries share a common definition for 
the first 12 bytes. The shared names are: 

ENAME ETTR ETYPE 

(8 bytes) (3 bytes) (1 byte) 
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Individually named fields follow either ETTR or ETYPE. 


The entries in a SYSCTLG block begin in the third byte of the 
block. The first halfword of the block contains tha binary 
number of the bytes that are used in this block, including the 
halfword count field. 


ALTAS ENTRY (AE) 


An alias entry defines an alternate name for the high-level 
qualifier of a data set name. 


Bytes and Name and 
offset Alignment Content Field Description and Meaning 


Name: contains the alias of the high-level 
index whose relative track address is found 
at offset 8 of this entry. 

















Address: contains the relative track address 
CTTR) of the first block of the index named 
at offset 12 of this entry. 










Type: indicates that this is an alias eantry; 
also that four halfwords follow in the 
remainder of the entry. 






X'04"' 











ETRUEN True name: contains the name of the index 
whose alias appears at the beginning of this 


entry. 


CONTROL VOLUME POINTER ENTRY (CVPE) 


A control volume pointer entry can appear only in volume 
indexes. Two forms are possible: the old form, created prior to 
Release 17 of IBM System/360 Operating System, and the new form, 
created since that release. Both forms are shown here. 


Old CVOL Pointer Entry 


Name and ; | 
Content Field Description and Meaning 
Name field: contains a high-level name that 
appears in the volume index of the control 
volume identified at offset 12 of this entry. 
ETTR Zero field. 
X'o00000' 


ETYPE Type: indicates that this is either an old 

xX'O3’ CVOL pointer entry CCVPE), or an index 
control entry CICE). An ICE always appears 
as the first record of an index level; a CVOL 
pointer entry always appears in the volume 
index. This is also the number of halfwords 
that follow in the remainder of the entry. 


EVOLIDO Serial number of the control volume whose 
volume index contains an entry for the name 
found at the beginning of this entry. 
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New CVOL Pointer Entry 


Bytes and | Name and ee 
Offset Alignment Content Field Descripttoan and Meaning 
0¢0) Name: contains a high-level name that appears 
in the volume index of the control volume 
identified at offset 12 of this entry. 
8(8) ETTR Zero field. 
X"'000000' 


11(B) _ ETYPE Tyger Indicates thatthe 46m. nen-CVOL 
X05" 


pointer entry CCVPE) or the volume index 
control entry (VICE). The VICE always 
12(C) _ EDEVTYP 
16(10) a EVOLID 


appears as the first entry in the first block 
DATA SET POINTER ENTRY (DSPE) 






























of SYSCTLG; a CVOL pointer entry never 
appears as the first entry of the first 
block. Also indicates that five halfwords 
follow in the remainder of the entry. 










Control volume device type: contains the 
binary device code of the control volume 
whose volume index contains an entry for the 
name found at the beginning of this entry. 










serial number of the control volume whose 
volume index contains an entry for the name 
found at the beginning of this entry. 


A data set pointer entry can appear in any index level. It 
contains the simple name of a data set and from one to five 
12-byte fields, each of which identifies a volume on which the 
named data set resides. 


Bytes and | Name and 
offset Alignment content Field Description and Meaning 


Name: contains the simple name of the data 
set whose volumes are identified at offset 12 
of this entry. 














EDSCBTTR 





Address: contains either binary zero or, when 
the data set resides on only one volume, the 
track address (TTR) of the data set control 

block (DSCB) for this data set. 















Type: indicates that this is a data set 
pointer entry (DSPE). Also indicates the 
number of halfwords that follow in the 

remainder of this entry. 


EVOLCNT Volume count: contains the binary count of 
the number of volumes identified beginning at 


offset 14. 
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Bytes and Name and 
Alignment Content Field Description and Meaning 


14¢E) ~.-12 to EDATA Volume entries: contains from one to five 
60 l2-byte entries, each of which identifies one 
volume on which the data set resides. 
Catalog management neither uses nor checks 
the contents of this field. 


GENERATION INDEX POINTER ENTRY (GIPE) 


C 









A generation index pointer entry can appear in any index except 
a generation index. It corresponds to the simple name used in 
the relative name for a GDG data 


Bytes and Name and ae 
offset Alignment cantent Field Description and Meaning | 
7 0(¢0) | ENAME 


8(8) ETTR 
11¢B) ETYPE 
X'02' 


Cc 12¢€C) EGFLAGS 


13(D) EGMAXSIZ 
14(E) aa EGCURSIZ 


, INDEX CONTROL ENTRY (ICE) 












Name: contains the name of the generation 
index to which this entry points. 


Address: contains the relative track address 
of the first block of the generation index 
named in this entry, tn the form TTR. 









Type: tndicates that this 15 a generation 
index pointer entry (GIPE). Also indicates 
that two halfwords follow in the remainder of 
this entry. 














Flags: contains the options specified by the 
bide creator of the generation data group: 


ae 





DELETE option. 
EMPTY option. 









Maximum count: contains a binary number 
specifying the maximum number of generations 
allowed in the generation index at one time. 






Current generation count: contains the binary 
number of generations currently cataloged in 
the index. 


The index control entry is the first entry in all indexes except 
the volume index. 


Bytes and | Name and ae 
Offset Alignment Content Field Description and Meaning 
INAME Name: low value of binary 1 ensures that this 
X'00...Q01° is the first entry in the index. 
- 


| TLSTBLK Last block address: contains the relative 










track address of the last block assigned to 
the index, tn the form TTR. 
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ITYPE 
X'03! 


Type: indicates that this is either an ICE or 
an old CVOL pointer. An ICE always appears 
as the first entry of an index; an old CVOL 
pointer always appears in the volume index. 
Also indicates the number of halfvwords that 
follow in the remainder of the entry. 


11¢B) 










IFSTBLK First block address: contains the relative 
address of the block in which this entry 


appears, in the form TTR. 


12¢C) 


15(CF) ILIASCNT Number of aliases: contains a binary count of 
aliases assigned to the index. This count is 
always zero for indexes that are not 
high-level. An index cannot be deleted if 


this count 1s non-zero. 





Reserved. 


INDEX LINK ENTRY (ILE) 


An index link entry 1s always the last entry in any index block. 
It 1s used to link blocks of one index into a chain. 


Bytes and | Name and a 
offset Alignment Content Field Description and Meaning 
0(€0) ENAME Name: high value (Call bits on) ensures that 


XY FFE... FF" this its the last entry in the index. 


8(8) 3 ETTR Link address: contains the relative track 
address of the next block of the same index, 
if there 1s one, in the form TTR. tlhen this 
1s the last (or only) block, this field 
contains binary zero. 

11¢B) exate ETYPE Type: indicates that this is either an ILE or 

X'Ooo’ an IPE. The name field of an ILE always 
contains X'FFFFFFFFFFFFFFFF*: the name field 
of an IPE never does. Also indicates that 


there are no more halfwords in the entry. 








INDEX POINTER ENTRY (IPE) 


The tndex pointer entry can appear in any index except a 
generation index. It points to a lower index. 


Bytes and | Name and ; es ; 
Offset Alignment content Field Description and Meaning 
0¢€0) ENAME Name: contains the name of the index to which 
this entry points. 
8(8) 3 ETTR Index address: contains the relative track 
| address of the first block of the index named 
in this entry, in the form TTR. 
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Bytes and Name and 

Alignment Content Field Description and Meaning 


ETYPE Type: indicates that this is either an IPE or 

X*'0Q' an ILE. The name field of an ILE always 
contains X'’FFFFFFFFFFFFFFFF': the name field 
of an IPE never does. Also indicates that 
there are no more bytes in the entry. 


VOLUME CONTROL BLOCK (VCB) 


















A volume list can be recorded in one or more volume control 
blocks. Each volume control block is one block of the SYSCTLG 
data set, and can identify up to 20 volumes on which one data 
set is recorded. 

Note: This block is different from other blocks of SYSCTLG. 
The first halfword does not contain the number of bytes used in 


the block as do other SYSCTLG blocks. The fields VCBVOLCT, 
shown below, is the first halfword of the VCB block. 


Bytes and | Name and 
Offset Alignment Content Field Description and Meaning 


0¢0) VCBVOLCT | Number of volumes: contains the number of 
volumes identified in this and subsequent 
volume control blocks. This number 15 
reduced by 20 for each subsequent volume 
control block. For example, if a data set 
resides on 61 volumes, it uses four volume 
control blocks. This field of each blocks 
contains 61, 21, and 1l, respectively. 

2¢2) ~.- 12 to VCBVOLS Volume indentifications: contains from 1 to 

240 20 1l2-byte entries, each of which identifies 

one of the volumes on which the data set 
resides. Catalog management neither uses nor 
inspects the content of these entries. Each 
l2-byte entry contains a 4¢-byte device code, 
a 6-byte volume serial number, and a 2-byte 
data set sequence number. 


252CFC) 3 Chain address: contains the relative track 
- address of the next volume control block, if 
there 15 one, tn the form TTR. If this is 
the last Cor only) block of the volume 
control block, this field contains binary 
zero. 









VOLUME CONTROL BLOCK POINTER ENTRY (VCBPE) 


A volume control block pointer entry can appear in any index. 
It is used when a data set resides on more than five volumes. 
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Bytes and Name and 
Alignment content Field Description and Meaning 


Name: contains the simple name of the data 
set whose volumes are identified in the 
volume control block that 1s pointed to by 
this entry. 




















Address: contains the relative track address 
of the volume control block identifying the 
volumes containing the data set named in this 
entry, in the form TTR. 





Type: indicates that this is a volume control 
block pointer entry. Also indicates that one 
halfword follows in the remainder of this 
entry. 


12¢C) Pe. X'0000" Zero field. 


VOLUME INDEX CONTROL ENTRY (VICE) 


The volume index control entry is always the first entry in the 
first block of data set SYSCTLG. 


It is the control record for the entire data set, and acts as an 
ICE for the volume index. 


Bytes and Name and 
offset Alignment Content . Field Description and Meaning 
_ hes 
8(8) aa VLSTBLK 


11¢B) VTYPE 











Name: always contains a binary one to ensure 
that this 1s the first entry of the volume 
index. 

















Last block address: contains the relative 
track address of the last block of the volume 
index, in the form TTR. 








Type: indicates that this is the volume index 
control entry or a new CVOL pointer entry. 
The volume index control entry 15 always the 
first entry of the first block of SYSCTLG; a 
CVOL pointer 15 never the first entry. Also 
indicates that five halfwords follow in the 
remainder of the entry. 





VOLSTBLK 





Last block of the catalog: contains the 
relative track address of the last block is 
SYSCTLG, in the form TTR. 





Contains the number of TTRs in VCLSTBLK, 


X'O5! 
14(E) | VHIREC | 

Note that this field is the last byte of 

VCLSTBLK Coffset 12). 


track address of the first unused block in 


16(10) 3 VFHOLE 
| | SYSCTLG, in the form TTR. 





First available block: contains the relative 
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ENVIRONMENT RECORD CEREC DSECT) 


The environment record is writtan by module IGGOCLC7 under 
certain error conditions. This record is useful in diagnosing 
problems using the catalog management routines. Reading the 
ene record is described in "Diagnostic Aids" on page 













Bytes and Name and 
Alignment Content 





offset Field Description and Meaning 


Reserved. 


&8(8) ERTIME Time stamp, as produced by the TIME macro 
instruction. 

16¢€10) Gq ERCAMLST First four bytes of the caller's parameter 
list produced by the CAMLST macro 
instruction. 


20014) ERMODMAP Field MODMAP1 from WORKAREA. 


21¢15) ERFLAGL Field FLAG] from WORKAREA. 
22616) ERFLAG2 


23017) ERFLAG3 
24018) 


ERERRCOD 
26C1A) .-14 ERNAMTTR Level name, TTR, types and volcnt; the first 
14 bytes of a general entry. 
40¢€28) ERREGSV Contents of general registers 0 through 14 at 
the time the environment record is written 
Cregister 15 is destroyed by module 
IGGOCLC7). 
| 100664) =~ ERWA1L Contents of WORKAREA from offset 12 bytes 


(label TTR) through offset 39 bytes. 
128(80) ERINPUT 
146092) EROUTPUT 
40 





Field FLAG2 from WORKAREA. 





Field FLAG3 from WORKAREA. 








Fields ERRCATSV and ERRLOCSV from WORKAREA. 





First entry in INPUT. 
First entry tn OUTPUT. 
Field OPTNCCW from WORKAREA. 


164CA4%) EROPTNCC 
ise) | ao ~*YCERTOB 


Field IOB from WORKAREA. 





Fully qualified name provided by the caller. 


RPSD DSECT 


RPSD describes the CCW chain used for rotational position 
sensing (RPS) support. 


Offset Alignment Content Field Description and Meaning 
poco [sid nrsss | Set sector cm 
Pacey | 8 | restric | Tis to normal channel prosrom 
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Bytes and | Name and ; 

offset Alignment content Field Description and Meaning 

16¢10) RPSINPUT Four words: RPSCNVT, RPSDDKR, RPSR1, and 
RPSPTR. 

16¢€10) RPSCNVT Address of supervisor routine to convert 
sector value. 

20¢€14)3 RPSDDKR Block size (DD, 256 bytes), key length (K, 8 
bytes), and record number. 

24(€18) oe. ll RPSR1I Address of location of this DSECT during use. 


16 
4 
G4 
4 
28C1C) 4 RPSPTR Type and address: the first byte contains the 
device type code, and the last three dSytes 
32¢20) RPSAVE 

















contain the sector value. 





10-word register save area. 
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WORKCLCA WORK AREA 


Controller III creates WORKCLCA. The CVOL Processor gains 
control via an XCTL with register 12 pointing to WORKCLCA. For 
more information on WORKCLCA at processor invocation, see 
Figure 5 on page 14. 


Bytes and | Name and 
Alignment content Field Description and Meaning 
roof Reserve 


4(4) 44 WKCATNM Name of the non-VSAM entry that defines the 
CVOL Catalog in the VSAM Master Catalog. 

48(30) 44 WKCATANM Alias name in the VSAM Master Catalog that is 
related to WKCATNM. 


92¢5C) a WKCVOLVS Volume serial number of CVOL Catalog. 


98(62) Reserved. 


100(¢64) Address of CVT. 
104(68) 
108¢6C) 
112¢€70) 


116074) 


CVTPTR 
TCBPTR Address of TCB. 
SVRBSAV Address of SVRB. 
VSRC15 


REGI3SAV 


VSAM register 15 return code. 


CVOL Catalog Management register 13 save area 
address. 


120¢€78) LIMIT Limit of DO Loop. 
124(€7C) 


128(80) 


EXITSAV Address of Exit Prolog. 


CTGPLPTR Address of VSAM CTGPL. 
132084) 
136¢88) 


140¢8C) 


CTGFLPTR Address of VSAM CTGFL. 


CAMPLPTR Address of CAMLST. 
PRMLSTSZ Size of Dynamic Area to be freed for SVC 26. 
144090) 


216(0D8) 


XSAVAREA 
WKCAMLST 


Save area for all external references. 


CAMLST build area for calling CVOL Catalog 
Management. 


WKOPTNS 
WKPTR1I 
WKCVOLP 
WKPTRS 


Option bytes. 


Address of data set name. 


Address of CVOL = ZERO. 





Address of the CVOL Catalog Management output 
area. 
WKDSCBP Address of DSCB TTR. 


236CEC) GIPEPTR Address of Generation Index Pointer Entry 


CGIPE). 
240CFO) 
2440 F4) 
248CF8) 


PCCBPTR 
SAVERI 


Address of PCCB. 


Save area number of bytes in data set name. 


— 


N 


SAVERS Save area for register 3. 
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Name and ee 
Content Field Description and Meaning 


Bytes and 
Alignment 


Offset 
252CFC) 


SAVERS Save area for register 4. 
SAVER6 Save area for register 6. 


2566100) 


2600104) 


pe Reserved. 


Save area for 1 pointer. 


264(108) 
268(10C) 


272(110) 
2760114) 
280¢118) 





CVOL Catalog Management register 15 return 


| 284C11C) 4 | OSRCO CVOL Catalog Management register 0 return 
, code. 





288(120) 


peered ca ue tee tod a 


RELNUM Binary relative generation number. 





ENTCOUNT CTGFL entry byte count. 
LBASE Binary located base number. 
SBASE Binary supplied base number. 


Data Set Name hold area. 


2920124) 
2960128) 
S00C12C) 
3440158) 


44 
44 


LOCDSN 





Data Set Name hold area. 


388(184) WKBLANK Blank character to stop TRT on WKDSN. 
389(€185) .3 WKDSCBT DSCBTTR hold area. 


3920188) KEYTYPE Switch to indicate which key IGGOCLCA is 


currently operating under. X'00°=SVC, 
393¢€189) OLDKEY MODESET savekey area. 


X*FFY=USER. 
394(€18A) eee | INCORESW Switch to indicate type of block in storage. 


— 









X'OO"=NAME, X'FFI=TIR. 


395(C18B) PCCBSW DO WHILE controller. 
1 


373¢€175) ENQDEQSW X'00"=not enqueued, X'FF'’=enqueued (Cenqueuing 


on a chain of PCCBs). 


Passe [sid Reserves 
400¢190) Er Sis One of the following: 

Index name save area. 

CTGFL name being processed. 

GDG work area. 


WKYVOLST Volume list area. 








408(198) 
416C1A0) 


Number of volumes. 


WKVOLNUM 


WKVOLS Volume entries. 
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Bytes and Name and 
Alignment Content | Field Description and Meaning 
a Fae WKNXTTTR TTR to next block. 





681¢62A9) Reserved. 





634(2AC) Entire 2794 bytes needed for 0S CVOL CATBX or 
| RECAT only. 


Teasceney | 256 | TRTARLE | Trenalate ond Test Tables 
)9aacspo) | 4 LKDP LINK DCB pointer. 
| o4gcspa) | 8 LKNM 1 Name of module being Linked to. 
16 | ESTAELIST | ESTAE macro list form. 
WKTMPCNM | Temporary catalog name. 
2 Reserved. 
3720(D98) WKCLIASV IGGOCLCIA save area. 
f 48 WKSHRPRM 
}4 | accep Pointer to Allocate Catalog Control options. 


Pointer to ACCRWP2. 






Shared parameter area. 


ACCRWP1 


ACCJISCBP Pointer to TCBJSCB. 


4 
4 

| 4 
4 ACCCATP1 Pointer to ACCCATP2. 
4 | ACCALSP1 | Pointer to ACCALSP2. 
A 
4 
vA 
4 











14 | accDDNMP Pointer to zero. 
ACCRWP2 | Pointer to ACCRW. 

| ACCATP2 Pointer to WKCATNM Catalog Name. 
ACCALSP2 Pointer to WKCATANM Catalog Alias Name. 

4 Return data from Allocate Catalog control. 

2 Allocate Catalog Control Return Code. 
Allocate Catalog Control Reason Code. 
Allocate Catalog Control bits. 


3552¢(DE0} 16 ENQPARMA 


3552(DE0) | 4 | 
3556(DE4) | 12 ENQDEQPL 


WORKAREA DSECT 














ENQ@/DEQ parameter area. 
Area for TCB. 





ENQ/DEQ parameter list. 





WORKAREA serves all CVQL Processor catalog CSECTs as an 
intermediate storage, communications area, and buffers. 
BLDLAREA is a portion of WORKAREA that serves the resident BLDL 
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or a locate function, BLDLAREA is separate from 


fields in the WORKAREA overlay other fields, and 

an area can have more than one label. Figure 14 
these overlays occur, by label. The Listing for any 
more labels and more detail; only the most 

are shown here. 





When function is non-locate, one area (GETMAIN) 
is used for all purposes. 


When function is locate, two areas are used. Space 
for 





WORKAREA 


WO 
The 









IG 


WI 







BLDLAREA 


(Output) 


Figure 14. D 


RETDATA 
The caller's area* is redefined as RETDATA 
to pass data back to the caller. 


*The ‘caller's area’ in this context refers not to 
the caller of SVC 26 but to the module 
(!1GGOCLCA or IGGOCLCB) which calls 


previously. 


BLDL comes from GETMAIN. 






RKAREA 
caller’s area®* is used for WORKAREA 













GOCLCC. The caller’s area’ is actually 
thin the WORKCLCA data area described 







BLDLAREA 





ata Area Hierarchy 
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Bytes and Name and 

Alignment Content Field Description and Meaning 
BLDLIST List 
SAVETTRS appropriate, the name of the last 


parameter for BLDL or, when 





valid index level. 
NAME Name or alias in the entry that 
ALIASNAM is being operated on. 
Generation number portion of an | 
absolute GDG name. 
12¢€C) TTR Relative track address in the 
current entry, in the form TTR. 


15¢F) ree | Type of entry; also the binary 
number of halfwords following in 
the remainder of the entry. TYPE 
is interpreted as: 


Either an index pointer entry 
CIPE) or an index link entry 
CILE). The name field of an ILE 
always contains 
X"'FFFFFFFFFFFFFFFF’'; the name 
field of an IPE never does. 


Volume control block pointer 
entry CVCBPE). 


Generation index pointer entry 
CGIPE). 


Index control entry CICE) or old 


CVOL 


pointer entry (CVPE). An 


ICE always appears as the first 
entry of the index; a CVPE 
always appears in the volume 
index. 


Alias entry CAE). 


Volume index control entry 
CVICE) or new CVOL pointer 
entry CCVPE). The VICE always 
appears as the first entry of 
the first block of the catalog; 
a CVPE always appears later in 
the volume index. 


Data 
With 


DSPE 
DSPE 
DSPE 
DSPE 





set pointer entry (DSPE 
one volue identification). 


with two volumes. 
with three volumes. 
with four volumes. 


with five volumes. 
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Bytes and | Name and : ae 
Offset Alignment Content Field Description and Meaning 

16¢10) TRUE The true name related to the alias| 
in offset 4. 

16¢€10) VOLCNT Number of volumes indentified in 
DATA when the current entry is a 
data set pointer entry (CDSPE). 

16¢€10) a ae DATA Volume identification for DSPE. 

| 1 ERRCATSV Errer code generated for non- 

locate function. 

89¢€59) wl ERRLOCSV Error code generated for locate 

function. 


90C5A) 7 Switches declaring requested 


re 
function. 
91¢5B) oar ers 









88(58) 






The index control entry CICE) 
must be read. 







SYSCTLG has no more room during 
CATBX or BLDX function. 


The DCB/DEB was freed by SVC 28 
processing. 

















CATBX reauest. 
UCATDX request, 
Locate request. 
RECAT request. 


Switches used to specify flow of 
control. 


RPS device. 
Alias entry has been found. 


Sequence error. 







Last entry found was a CVOL 
pointer entry (CCVPE). 










Generation index pointer antry 
CGIPE) has been found. 





Alias entry has been built. 


tress seerecl 
92¢5C) SAVEAREA | Save area for temporarily storing 
the contents of general purpose 
| registers. 


| 120¢€78) 8 NEXTKEY The key or count of the next 
NEXTCNT block beyond the one read. 


128(80) 10 | ICE Index control entry. Ony bytes 8 
through 15 are saved here. | 
136088) | ee ale VICE Volume index control entry. Qnly 
bytes 11-18 are saved here. 
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Bytes and | Name and —— 
Alignment Content Field Description and Meaning 


Switches to invoke functions of 
IGGOCLCS5. 
Absolute GDG name found. 

-1l.. ..../ Free index blocks. 

: - .e--| Read a block for updating. 

re ----}| Process EMPTY option of 
generation data group (GDG). 

spaiaae is ..-| Write the last block of a GDG 
chain when the GDG is full anda 
new one is being added. 

ee» oL..] Build volume control blocks 
CVCBs). 

Echo a, “esse Free VCBs. 

ee ae ee Write a block. 


C 


1499(95) Switches to specify the flow of 


control in IGGOCLC6. 


New entry has been inserted into 
block now in the work area. 
Updating 1S in process. 


The updated block has been 
written into SYSCTLG. Updating 
1s complete. 


The block following the block 
pointed to by field WRITETTR is 
free. 


The first write has occurred. 


The block following the block 
pointed to by field LINKTTR is 





free. 


1 
1 
150( 96) NAMELEN Length of the full name given by 
caller minus 1. 
152¢€98) 4 NAMDELMP Address of last delimiter in 
, | given name. 
156€9C) 4 NAMLSTP Pointer to Last displacement of 
given name in the name table. 
od 


Flag bits. 


161CA1) 


CVOL has extended security. 


Switches to specify flow of 
control in IGGOCLC7: 


Low-level index is involved. 
VFHOLE needs to be updated. 
LSTBLK needs to be updated. 





FSTBLK needs to be updated. 
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Bytes and Name and J 
Offset Alignment Content Field Description and Meaning 


162CA2) MODMAP 1 Trace of modules that have been 
entered. The appropriate bit is 
set to 1 as each module is 
entered. There is no bit for 
subroutine IGGOCLCO, because it 
is always entered before any 
other. 
IGGOCLCI 
IGGOCLC2 
IGGOCLC3 
IGGOCLC4 
IGGOCLCS5 
IGGOCLC6 


IGGOCLC? 



















Address of the entry point of the 
supervisor routine BLDL. IECPBLDL 
(copied from field CVTPBLDL of 


eer ete es 

164CA4) 4 EPBLDL 
the CVT) 

168CA8) 4 BLDLISTP | Address of the list to be 
completed by BLDL Caddress of 
field BLDLIST, offset 0 of this 
DSECT). 

172CAC) 4 DCBADDR Address of the data control block 
CDCB) for the control volume. 

176(B0) 4 DEBADDR Address of the data extent block | 
(DEB) for the control volume. 

180¢(B4) 4 FOUNDENT Address of an entry in an input/ 
output buffer. 


184(B&) 4 EPTQRLTV Address of the entry point 
IECPRLTV, a supervisor routine 
| that converts absolute track 
addresses to relative track 
addresses (copies from field 
CVTPRLTV of the CVT). . 
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Bytes and 
Alignment 


Name and 
Content Field Description and Meaning 


EPTOABSL 


C 


Offset 
188¢(BC) 


Address of the entry point 
IECPCNVT, a supervisor routine 
that converts relative track 


addresses to absolute track 
addresses (copied from field 
CVTPCNVT of the CVT). 


SVRBEXTP Address of the extension of SVRB. 


Address of new entry, meaningful 
only when bit 0 of FLAG4 is X'1'. 


SVBALREG Branch and link register save 
area. 


LNKENTRY General form of index link entry 
CILE). The first eight bytes 
contain X'FFFFFFFFFFFFFFFF’. 





192¢C0) 
196 (C4) 


200¢(C8) 


: 


204(CC) 
216(D8) 


ad 
RO 


224(E0) LINKTTR Last four bytes of LNKENTRY: 


contains the TTR for this ILE. 


WRITETTR Save area for relative address of 
block to be written. 


ICETTR Relative track address of block 


2280 E4) 





232(0E8) 


that contains an index control 
entry CICE). 





236(CEC) 


SAVETTR Save area for any relative track 
address. 

READTTR Save area for relative address of 
block to be read. 

CWAP Pointer to catalog controller 
work area. 

NAMLF Number of levels of the name that 
were found. 


NAMLG Number of levels in given name. 


DEVTYPE Device-type portion of an 
identification. 


THETA 


C 


240 CFO) 


244 (0F4) 


2480 F8) 


250(FA) 
252CFC) 


2560100) 


Angular displacement value 
(theta) for rotational 
positioning support CRPS). 


2570101) INDEXLEN Length of all levels given except 
the last. Used with SCRATCH macro 


instruction. 
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Bytes and | Name and ; eae : 
offset Alignment Content Field Description and Meaning 
258(102) ERRSV2H Exceptional return code from 
subroutine IGC0002H. 
259(€103) VOLSN Serial—number portion of a volume 
identification. 
Data set name to be scratched 
when processing GDG data sets. 
SCRPARM Parameter list for SCRATCH macro 
instruction. 
SCRVOLS Volume list for SCRATCH macro 
instruction. 


= —_ 


16(10) 


60C3C) 


72648) 


Name table containing the length 
and displacement of each 
component of tne given name. 


76(4C) Last delimiter in the given name, 


either b, or ‘'C'. 


az a 


128(80) Work area for Convert—-to-Binary 
CCVB) instruction used with 


relative GDG processing. 


136(88) PKDNUMBR Work area for PACK instruction 


used with relative GDG processing. 


RETDATA Volume list returned to caller. 


REDSCBT Relative track address of the 
DSCB tn the VTOC for a single- 
volume data set, as returned to 
the caller. 


259(€103) RETCVOL Serial number for the control 
volume containing the returned 
volume list. 

2650109) VICESAVE Save area for volume index 
control entry (CVICE) information. 

268C10C) 4 BALREGS Save area for register used in 
BAL tnstruction. 





0(0) 
2520FC) 







1 
44 
4 
44 
1 
4 





- 
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272¢110) 400 BLDLAREA Work area for use by BLDL routine; 
for a locate function, WORKAREA 


| oe 
< 
N 
oO 
il 
00 
ve) 
wn 
o 


is in two parts, and BLDLAREA is 
the second part. 





2720110) 48 


SVAREA2H Register save area for 
subroutine IGCOO02H. 
ESTAEPRM ESTAE exit routine parameter list. 
ESTAESVA ESTAE information area for ESTAE 
error exit cleanup. 
ESTAELST ESTAE record parameter List. 
BLDLCNT Parameters for BLDL routine. 


BASESAVE 


3206140) 


336¢€150) 2 


ms 


i _ 
Oo oa 


360¢168) 
632(¢278) 120 


752°02F0) 


Save area for the register that 


would otherwise be destroyed by 
BLDL. 


RESALTIAS Work area used when resolving an 
alias name. 





oS) 
a 


6406280) 4 





3760178) 256 INPUT Input buffer for channel program. 

376¢178) TRTABLE Translate table used with TR 
instruction to analyze the given 
nane. 

6320278) SIDE Search—-ID—-Equal CCW. 


6400280) TIC! Transfer—In-Channel CCW. 





648(288) OPTNCCW CCW that is changed to do the 


required input/output function. 


RC Read-Count CCW. 
Search—-Key—Equal CCW. 


TIC2 Transfer—In-Channel CCW. 


NOP CCU. 


Event control block for channel 
programs. 


656(290) 
664(298) 
672(2A0) 


680(02A8) 


688(2B0) 


ECB 
67202B4) 0B 


I Input/output block for channel 


programs. 


2) 
A 
Oo 


73202DC) 
74002E4) 
748C2EC) Write-Key-Data CCW. 


756C2F4) 264 OUTPUT Cutput buffer for channel 
programs. 


Read—Key—Data CCW. 





Read—-Data CCW. 


— 
=) & 


1974,1982 
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CAMLSTD DSECT 
CAMLSTD describes the parameter list provided by the caller of » 
CVOL Catalog Management. It maps the result of the CAMLST macro 
instruction. 


Bytes and Name and 
Alignment Content Field Description and Meaning 


CAMOPTNI First option byte. 


offset 
0¢0) 
Catalog is not on SYSRES. 


CAT or CATBX request. 


RECAT request. 

UNCAT or UNCATDX request. 
Locate-by—block request. 
1¢1) Second option byte. 

Do not allocate a catalog. 
BLDX or CATBX request. 
BLDG request. 

BLDA request. 

LNKX request. 


DLTX or UCATDX request. 





DSCB TTR has been specified. 
DLTA request. 


e 


22) Third option byte. 

DRPX request. 

Scratch GDG data sets. 
Empty generation index when 


maximum generation count is 
reached. 





VS CAMLST. 


VSAM parameter list. 


Scares, Nest 


CAMPTRI Address of the name field in 
caller's area. For locate—-by— 


3(€3) 
4(4) 
block, the name field contains a 


relative track address instead of 
a name. 


4 CAMCVOLP Address of CVOL Catalog volume 
serial number (a 6—byte field). 





8(8) 
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12¢C) CAMPTRS Address of caller's third 

parameter. Meaning depends on the 

function: 

Locate Caller's 265~-byte work 
area 

BLDA 8-byte name field 

LNKX 10—-byte volume 
identification 

CAT, CATBX Volume list 

or RECAT 

Other Not used 


16(10) CAMDSCBP | Address of three-byte field 


C 





















containing the relative track 
address (TTR) for the Format I 
DSCB for the data set named 

through CAMPTRL. 
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DIAGNOSTIC AIDS 


This chapter provides several aids that can be useful when 
diagnosing difficulties with the CVOL Processor. Before you use 
the following diagnostic aids, be sure that the CVOL Processor 
received control as a result of your SVC 26 instruction. That 
is», make sure that the CVOL Catalog you are referencing is 
properly defined in the VSAM Master Catalog. Also make sure that 
the data set you are referencing is defined as an alias of the 
CVOL Catalog if you are not explicitly specifying the CVOL 
volume serial in your SVC 26 request. You can use the Access 
Method Services LISTCAT command to list the VSAM Master Catalog. 
Refer to Access Method Services Reference for more information 
on the LISTCAT command. Refer to Catalog User's Guide, for more 
information on how to set up the CVOL Processor. 





SUBROUTINE SELECTION CHARTS FOR CSECTS IGGOCLCA AND IGGOCLCB 


Figure 15 on page 115 can help you determine which subroutine of 
CSECT IGGOCLCA is involved in any given situation. The figure 
consists of several charts. Each chart shows the path through 
CSECT IGGOCLCA for the function(s) noted with that chart. 


Only subroutine GENLOC calls CSECT IGGOCLCB. Therefore, the 
GENLOC chart show the path through IGGOCLCB as well as the path 
through IGGOCLCA. 


Note: The entry point for the CVOL Processor, CSECT IGGOCLCA, 
the subroutines IGGOCLC1A and SRCHPCCB, and thea external 
subroutine IEFABGF5 are common to all of the functions 
represented in these charts. 
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1974,1982 





OS CAMLST Format Request 


IGGOCLCC 


GETUSERK 


GETSVCK 









VSAM DELETE 







LOCNAME 





MGC LC 
Gt TUSERAK 
Gil ISNCK 








Figure 15 (Part 1 of 6). 


MaGOCLCC 


ic: 


Subroutine Selection Charts for CSECTs 


IGGOCLCA and IGGOCLCB 
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SUPERLOCATE with GDG Base Supplied } 


IGGOCLCC 












IGGOCLCC 





LOCTTR 


IGGOCLCC 










LOCTIR 


IGOACLOC 


MGOCLCC 


GETUSERK 
GETSVCK 





GETUSERK 


GETSVCK 


LOCTTR 






IGGOCLCC 


Figure 15 (Part 2 of 6). Subroutine Selection Charts for CSECTs 
IGGOCLCA and IGGOCLCB } 
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SUPERLOCATE GDG Base Only 










LOCNAME 


IGGOCLCC 


GETUSERK 
GETSVCK 


GETUSERK 
GETSVCK 


a: 


IGGOCLCC 
IGGOCLCC 


GETUSERK 


GETSVCK 


Figure 15 (Part 3 of 6). Subroutine Selection Charts for CSECTs 
IGGOCLCA and IGGOCLCB 
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SUPERLOCATE - Normal SUPERLOCATE Jd 


IGGOCLCC 














GETUSERK 


GETSVCK 


GE TUSERK 


GE TSVCK 


IOGOCcL.Ce 





Mi GOCLCC 


IGGOCLCC 


Figure 15 (Part 4 of 6). Subroutine Selection Charts for CSECTs 
IGGOCLCA and IGGOCLCB 
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( SUPERLOCATE with GFNERIC LOCATE Specified 


GETUSERK 
GETSVCK 










IGGOCLCC 


IGOCLCC 


Figure 15 (Part 5 of 6). Subroutine Selection Charts for CSECTs 
} IGGOCLCA and IGGOCLCB 
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VSAM LOC VEE OR VSAM LOCATE-LISTCAT (NOT-GET NEXT) 


VLOC 
GETUSERK 
GETSVCK 


LOCNAME 















IGGOCLCC 


One or more of the following: 
GETUSERK 


GETSVCK 
ite: 


Gi TUSERK 
Gil ISVCK } 


GE TUSERA 
GC: ISVCK 








GU TUSEFRA 


GE TSVCK 


GETUSERK 


GE ESVCK 


Figure 15 (Part 6 of 6). Subroutine Selection Charts for CSECTs 
IGGOCLCA and IGGOCLCB 


J 
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CTION CHARTS FOR CSECTS IGGOCLCC G cD D_ IGGOCLC 


Figure 16 can help you determine which subroutines of the CVOL 
Catalog Management CSECTs are involved in any given function. 
The figure consists of several charts that are modifications of 
Figure 11 on page 26 of this publication. Each chart shows the 
path through the CVOL Catalog Management subroutines for the 
functions noted on that chart. The specific path is shown by an 
arrow. Always enter subroutine IGGOCLCO, which is the entry 
point for CSECT IGGOCLCC Cupper left), then move down and to the 
right. 


LOCATE Simple or Qualified Name LOCATE Relative GDG Name 
with an Altas 





IGGOCLCO 
}  IGGOCLC2 ! 









DLTX,. BLDX, BLDG. LOCATE Relative 
DRPX,. DLTA GDG Name 





LOCATE Qualified Name 


with an Alias 





Figure 16 (Part 1 of 3). Subroutine Selection Charts for CVOL 
Catalog Management 
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CATBX . ) 










CAT, UNCAT. RECATLG, UCATDX 
| IGGOCLC2 | 
| IGGOCLES_] 
| 1GGOCLEa_ 
| IGGOCLCe 


4 


KG GOCLC7 





LNKX and BLDA 





in GGO0CLC7 


Figure 16 (Part 2 of 3). Subroutine Selection Charts for CVOL 


Catalog Management ) 
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Catalog functions with VCB processing required. 


GDG Empty option required, or blocks to delete 


(UCATD®) 





Figure 16 (Part 3 of 3). Subroutine Selection Charts for CVOL 
Catalog Management 


All the CVQL Processor CSECTs use the ESTAE macro for error 
analysis. For more information on the ESTAE macro, refer to 


Supervisor Services and Macro Instructions, and System 


Programming Library: Supervisor. If you get a system completion 
code of "1LiA™ when running the CVOL Processor, it is because the 


ESTAE macro determined that the error was caused by bad 
information in the parameter list passed by the SVC 26. 
The following items are useful in diagnosing errors: 


° Source or input Listings related to the use of the CVOL 
Processor. 


e Main storage dump produced by using a //SYSABEND DD 
statement. 


e Listing of a CVOL Catalog data set. 


Two kinds of dumps can be used while diagnosing trouble with the 
CVOL Processor: 


e Main storage dumps and, 
® CVOL Catalog data set dumps. 


This section points out significant diagnostic clues to look 
for. It does not explain the full meaning of dumps; for that 


information, see Debugging Handbook. 
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MAIN STORAGE DUMP 


Each CSECT of the CVOL Processor has its own identifier. The 
identifier is eight characters long, IGGOCLCA for example, and 
appears in the first few bytes after the entry point of the 
CSECT. 


If an ABEND dump was produced because of an error in one of the 
CVOL Catalog Management CSECTs, then look at the content of the 
general registers at the time of the ABEND. The most 
significant registers are: 


Register 6 Pointer to WORKAREA. The field MODMAPI1 shows which 
subroutines have been entered; compare this to the 
expected path for the requested function. The 
section "Subroutine Selection Charts" for CVOL 
Catalog Management in Figure 16 on page 121 shows 
the path for each function. 


Register 8 Pointer to CAMLST passed to IGGOCLCC. This CAMLST 
may he either tne original CAMLST Cbuilt by the 
issuer of the SVC 26 instruction), or a CAMLST built 
by the Interface Mappers. 

REGISTER USAGE FOR THE CVOL PROCESSOR 
None of the CVOL Processor CSECTs use standard register linkage. 
Refer to the following lists for registers used by each CSECT. 
Register Usage for CSECT IGGOCLCA 


Recister Meaning 


10 Second base register for CSECT 
Ll First base register for CSECT 
12 Base register for WORKCLCA structure 


Recister Usage for CSECY IGGOCLCB 
Register Meaning 
ih Base register for CSECT 


i Ge Base register for WORKCLCA structure 
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Register Usage for CSECTsS IGGOCLCC, IGGOCLCD, and IGGOCLCE 


C Register Meaning 


4 Base register for the CSECT 

6 Base register for WORKAREA DSECT 

8 Base register for CAMLSTD DSECT 

12 Linkage register for BAL instructions 
14 Linkage register for BAL instructions 


CVOL CATALOG DUMP 


There are several ways to dump a data set; this discussion 
assumes that AMASPZAP is used. AMASPZAP is a service-aid 
program that operates under the operating system. AMASPZAP is 
described in System Programming Library: Service Aids. 


To dump the catalog with AMASPZAP, use the following JCL, where 
the //SYSLIB DD card points to the CVOL to be dumred: 


//DUMPSTEP EXEC PGM=AMASPZAP 
S/SYSPRINT DD SYSOUT=A 


S/SYSLIB DD DSNAME=SYSCTLG,UNIT=uuuu, 

// VOL=SER=volser,DISP=-OLD, 

// DCB=(KEYLEN=8) 

//SYSIN DD * 

ABSDUMP ALL 

1% 
This JCL is used to dump the entire catalog. You can dump a 
portion of the catalog by specifying beginning and ending track 

addresses. 


The DCB parameter KEYLEN in the "//SYSLIB DD" statement formats 
the key as well as the data for each block. The key appears as 
the first two words of the first line of each block. The data 
for the block begins tn the third word. 
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EXAMPLE OF A CVOL CATALOG DUMP 
in the 


Figure 17 shows an actual dump of the catalog. Entries 











volume index are outlined, and other blocks of the catalog are 
identified. 
KEY CNT VICE IPE ILE CVPE 
DSPE **®CCHHR- (0001000601 RECORD LENGTH- 0108 ae 
OOO |‘FFFFFFFF = FFFFFFFF | '0074p000 ' 00000000 0010000 01050000 11000000 7000000 
00002 C4C5D7E3 40404040 96000007 00013000 2001C4E4  D4&E5D6D3 O000GC9D5 ~ E5D5E3D6 Alias 
000040 | D9E80000 00053000 200!1FOFO  FOFOFOF) D7C1E8D9  D6D3D340 00000200 J D7D940wer7 
000060 § 40404040 00000204 O7CIE8D9  D6D3D340 FFFFFFFF  FFFFFFFF 00000000 | 00000000 















































































OocGHO | 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
00000 | 10000000 00000000 00000000 od00v00000 00000000 00000000 99000000 00000000 
0000c0 | LV0000000 40000000 00000000 00000000 00000000 00000000 00000000 90000000 
OOOOEO | G0000000 )0vG0000 00000000 00000000 00000000 00000000 _00000000 _ 00000000 
000100 | 00000000 00000000 CNT mE 
KEY .28CCHHR- 0001000602 — RECORD LENGTHY 0108 First block of 
SOOT ICSEDED 40404040 [| OOFEPO00 00000000 00010000 “ 02030000 _ 02010000 SS index ‘PAYROLL’ 
000029 | C9E5C540 Q000001F 90053000 2001C4E4 D4ESD6D3 ~=00003000 = 2001Cc4z4 ESD3F1 
000040 | 00003000 2001C4E4 D4ESD3F2 000030C0 2008ESC3 = C2C3D2F1  000030C0 2008ESC3 
000080 | C2c3D2F2 0000D3C1 «"2D6D940 40400000 VOIFOOOS 30002001 C4E4D4ES 16D 10000 
000080 | 30002001 C4E4D4ES ~~ b3F1V000 ~—- 30002001 C4E4D4E5 = D3F20000 =30C02008 = £9€3C203 
OO00AO | D2FIN000 30C02008 = EST3C2C3 =~: D2F20000 D3IC9E2E3}} 40404040 0000001F 00053000 
0000CO | 2001C4E4 D4ESDEDI = YOVNIVOD = 2001C4E4 D4ESD3F1 00003000 2001C4E4 D4ESD3F2 
OOOOEO | 3H0030C0 = 20UKESC3) = C20 IDZF1 ~~: 000030C0 2008E5C3C2C3D2F2  -OOOOFFFF ss FFFFFFFF 
000100 | FFFFOOD0 v30000U0 
KEY 2SCCHHR- OUI uLhOy RECORD LENGTH- 0108 
OOUOIO—~ = FFFFFFFF FPFFFFFFF OOCOD4D6 DSE3C8D3 E8400000 001F0005 30002001 C4E4DSES Second block of 
000020 | DéD}0000 = =30002001 = C4ESD4ES ~—— D3 F 10000 30002001 C4ESD4E5 DIF20000 te index ‘PAYROLL’ 
000040 | ESC3C2C3 =D2F10000 = 30C 02008 ~— ESC: 3C203 D2F20000 D9CSD7D6 = =—D9E3404N ~+)1N0001F 
000060 | vbU53000 2001C4E4 Da4ESD6D3 00003000 2001C4E4 D4ESD3F1 00003000 2001CuE4 
000080 | D4ESD3F2 vOv030CO 2008ESC3  C2C3D2F1 000030CO 2008E5C3  C2C3D2F2 0000E2C1 
QOOOAO | D3C1D9EB 40400000 04010000 £3c9D4C5 C3C1D9C4 00000502 00050004 FFFFFFFF 
O0O00CO | FFFFFFFF 00000600 00000000 00000000 00000000 00000000 00000000 00000000 
QO00EO | CDDCVOLVO 110000000 09000000 10000000 00000000 00000000 00000000 00000000 
000100 | 00000000 —_vdVv00000 VOLCNT 
KEY SeCCHHR- 0001000604 RECORD LENGTH 0108 | 
FFFFFFFF  FFFFFFFF | O00 7B000 2001C4E4 D4ESD6D3 00003000 2001C4E4 D4ESD3FI 
000020 | 00003000 2001C4E4 D4ESD3F2 000030c0 2008E5C3 C2C3D2F1 000030CO0 2008E5C3 
000040 | c2c3D2F2 000030CO0 = =2008ESC} = C2C 3D2F3 000030CO 2008E5C3  C2c3D2F4 00000000 
000060 | 00000000 00000000 00000000 0000000 0000000 00000000 00000000 _ 90000009 Volume control 
000080 | 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 block 
0000a0 | 00000000 90000000 00000000 00000000 00000000 00000000 00000000 00000000 
o000Cc0 | 00000000 00000000 00000000 00000000 00000000 90000000 00000000 00000000 
OO000EO | 00000000 00000000 00000060 00000000 00000000 00000000 00000000 00000000 
000100 | 00000000 00000000 
**CCHHR- 0001000605 RECORD LENGTH- 0108 
KEY —noqeee—FFFFFFFF FFFFFFFF | 00860000 00000000 00010000 05030000 05000000 C70FOFOF 
000020 | OBESFOFO 00000007 00013000 2001C4E4 D4ESD6D3 O000C70F OFOFOCES  FOFO0C0O 
000040 | 00070001 30002001 C4E4D4ES5  D6D30000 C7OFOFOF ODESFOFO 00000007 00013000 
000060 | 2001C4E4 D4ESD6D3  OOOOC70F OFOFOEES FOFO0000 00070001 30002001 C4ESD4ES 
000080 | D6D30000 = ~FFFFFFFF FFFFFFFF 00000000 00000000 00000000 00000000 _ 00000000 
O000A0 | 00000000 00006000 00000900 00000000 00000000 00000000 00000000 00000000 Generation index 
0000cO | 00000000 00000000 00000000 00000000 V0090000 =00000000 =00000000 = 00000000 
0000£0 | 00000000 00000000 — 00000000 00000000 00900000 00000000 00000000 _ 00000000 
000100 | 00000000 00000000 
®*CCHHR- 0001000606 RECORD LENGTH- 0108 
































































220000. FFFFFFFF FFFFFFFF OOA2ZE3D6 E3ICIDIE2 40400000 001F0005 30002001 CUEGDGES 
KEY 000020 D6D30000 30002 C4E4D4ES D3F 10000 30002001 C4ESD4ES D3IF20000 30C02008 

000040 ESC 3C2C3 D2F 10000 30C 02008 ESC 3C 203 D2F 20000 E8D9E 3D6 C4CTE3C5S VOOOO001F 

000060 0005 3000 200 1C4E4 D4E5SD6D3 00003000 2001C4E4 D4E5D3F1 0000 3000 2001C4E4 

000080 D4E5DIF2 000030C0 2008E5C3 C2C3D2F1 0000 30C0O 2008F5C 3 CéCI3D2F2 OOOOFFFF 

O000A0 FFFFFFFF FFFFOOOO 00000000 00000000 YQ000000 00000000 00000000 Third block of 
0000C0 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 : i ' 
OOOOEO 00000000 00000006 o0000000 00000000 00006000 00000000 00000000 00000000 index ‘PAYROLL 
000100 00000000 00000000 





®*®CCHHR- 0001000607 





RECORD LENGTH- 0108 


















00000 00000000 OuaQu0d00 10000000 0000000 00000000 00000000 00000600 06000000 
KEY 00020 00000000. 00000000 vo0Qn0000 00900000 00000000 00000000 00000000 00000000 
900040 | 00000000 00000000 00000000 00000000 00000000 00000000 00000000 0000000 
000060 00000000 NOVOOOONY YVONV0000 Q0000000 90000000 VvOdd0000 oo00000a 000000 Unused block of 
nner 100900 _atQ000000 = VLU0VD0OD__ 00000 DDR men 0000C DADC 2000000 = 00000000 nen0000 SYSCTLG 
Figure 17. Sample Dump of the CVOL Catalog 
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ENVIRONMENT RECORD 


The data portion of each block begins with a 16-bit binary 
number that tells how many bytes of the block are used 
Cincluding the two bytes of this number). The catalog entries 
begin immediately thereafter. These entries are described in 
detail in the chapter "Data Areas." 


The first entry of the first block is always the volume index 
control entry (VICE). The type of each entry can be determined 
from the byte at offset 11 of the entry; the type codes are 
described under the field TYPE in the WORKAREA DSECT found in 
"Data Areas" on page 92. 


Some error conditions cause an environment record to be written, 
whenever possible, to the last block of the CVOL Catalog. The 
environment record is written when a nonlocate function is 
requested, and the exceptional return code is 8 or 28. Here's 
how you can dump the catalog and examine this record to see what 
happened: 


1. Reproduce the failure, but this time reserve the data set 
CVOL Catalog for your exclusive use, so that no other task 
can destroy the environment record before you can dump it. 
Do this by adding or modifying your JCL statements to 
include a DD statement for CVOL Catalog with DISP=OLD. 


2. Adda step to your job to dump CVOL Catalog. Follow the 
instructions under "CVOL Catalog Dump." 


Oe Look at the VICE, which begins at offset two of the first 
physical block of the catalog. (Remember to allow for the 
key.) Field VCLSTBLK Coffset 12 bytes in the VICE) contains 
the TTR for the last block in CVOL Catalog. This block 
contains the environment record. 


G4. Compute the absolute track address by using the 
cylinder-head numbers supplied for the first block and the 
TTR. TT is the relative track from the first block; R is 
the record number for that track. 


5. The fields of the environment record are described in 
"Environment Record CERECT DSECT)," in the “Data Areas" 
chapter of this publication. The description for each field 
relates this information to other data areas. 


The field ERMODMAP contains seven bits that show which 
subroutines have been entered. IGGOCLCO is always entered; 
there are no bit switches for this subroutine. 


As an example, if ERMODMAP equals X'76', then modules IGGOCLCO, 
IGGOCLC2, IGGOCLC3, IGGOCLC4, IGGOCLC6, and IGGOCLC7 were 
entered during the request that caused the environment record to 
be written. This is the sequence of subroutines that normally 
occurs with a request for CATBX. 


Note: The environmental record is not written for any error 
associated with a "catalog-full™ condition. 
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This glossary contains definitions of 
words and acronyms that are used in this 
publication. Other data processing 
definitions can be found tn Vocabulary 


for Data Processing, Telecommunications, 
and Office Systems. 


alias. An alternative name for a data 
set. In a CVOL Catalog, only the 
high-level name of a fully qualified 
data set name may have an alias. 


cataloged data set. In a CVOL Catalog, 
a data set that 1S represented in an 
index or hierarchy of indexes that 
provides the means for locating the data 
set. 


communication vector table (CVT). An 
operating system control block that 
provides the address of information in 
the nucleus to nonresident routines. 


control volume (CVOL). An OS5/VS Catalog 
that contains one or more of the 
indexes. 


CVOL catalog. The collection of all 
data set indexes maintained by CVOL 
Catalog Management. 


data control block (DCB). An operating 
system control block that describes the 
current use of the data set. 


data extent block (DEB). <A control 
block that describes the physical 
attributes of the data set. 


data set. The major unit of data 
storage and retrieval in the operating 
system. 


data set control block (DSCB). A label 
for a data set ona direct storage 
volume. 


data set name. An identifier that 
unambiguously names a data set. 


data set pointer entry (DSPE). A CVOL 
Catalog entry that identifies the volume 
on which a named data set resides. 


DEQ. An Assembler language macro 
instruction used to remove control of 
one or more serially reusable resources 
from the active task. It can also be 
used to determine whether control of the 
resource 15 currently assigned to or 
requested for the active task. 


dequeue. To remove a request for a 
resource from a list of requests. 


ENQ. An Assembler language macro 


instruction that requests the control 
program to assign control of one or more 
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serially reusable resources to the 
active task. It is also used to 
determine the status of resource, that 
is, Whether tt 1s immediately available 
or in use, and whether control has been 
previously requested for the active task 
in another ENQ macro instruction. 


enqueue. To build a list of requests 
for a named resource. 

entry. A logical record of a catalog. 
environment record. A 256-byte record 
that is written when CVOL Catalog 
Management discovers an error. This 
record, which contains significant data 
that is present at the time of the 
error, is written to the last block of 
data set SYSCTLG for later analysis. 


ESTAE. <A Supervisor macro instruction 
used to extend the recovery capability 
of the STAE macro. ESTAE provides more 
levels of recovery than the STAE macro. 


EXCP. An Assembler language macro 
instruction that requests the initiation 
of the I/0 operations of a channel 
program. 


FREEMAIN. An Assembler language macro 
instruction that releases one area of 
main storage that had previously been 
allocated to the job step as a result of 
a GETMAIN macro instruction. 


generation. 
data group. 


One member of a generation 


generation data group (GDG). A 
collection of historically related data 
sets. 


generation index. An index of the CVOL 
Catalog that tdentifies the generations 
of a generation data group. 


generation index pointer entry 
(GIPE). A CVOL Catalog entry that 
identifies a generation index. 


GETMAIN. An Assembler language macro 
instruction that is used to allocate an 
area of main storage for use by the job 
step task. 


high-level name. The first component of 
a qualified name. This name is found in 
a volume index of the CVOL Catalog. 


index. A table in the CVOL Catalog 
structure that is used to locate data 
sets. 


index control entry (ICE). The first 
entry of each index of the CVOL Catalog. 
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This entry contains all control 
information about the index. 


index link entry CILE). The last entry 
of each block of the CVOL Catalog, used 
to link blocks of one index together in 
a chain. 


index pointer entry (IPE). A CVOL 
Catalog entry that attaches a 
lower-level index to the index in which 
it 1s found. 


level. <A conceptual relationship 
between indexes of the CVOL Catalog. 
The index corresponding to the simple 
name of a data set 1s said to be the 
lowest level; the first component of a 
qualifier name is said to correspond to 
the highest-level index. 


LINK. An Assembler language macro 
instruction that causes control to be 
passed to a specified entry point. The 
linkage relationship established is the 
same as that created by a BAL 
instruction. 


locate. Pertaining to functions that do 
not change the status of a catalog; that 
is, read-only operations are performed. 


MODESET. A Supervisor macro instruction 
used to change the system status by 
altering the PSW key or the mode 
indicator. 


must-complete. An indication to the 
operating system that the event must be 
performed without interruption or 
warting. 


nonlocate. Pertaining to functions that 
change the status of a catalog; that 15, 
write operations are performed. 


partitioned data set directory. The 
portion of a partitioned data set that 
provides a means of locating any of the 
members of the data set. 


qualified name. A data set name 
consisting of a string of names 
separated by periods; for example, 
"TREE.FRUIT.APPLE” is a qualified name. 


qualifier. Each component name in a 
qualified name other than the rightmost 
name. For example, "TREE™ and "FRUIT" 
are qualifiers in "TREE.FRUIT.APPLE."” 


relative track address (TTR). A 
direct-access device address, expressed 
as a displacement ina data set. This 
address has the form TTR, where TT 
represents two hexadecimal digits 
specifying the track relative to the 
beginning of the data set, and R is one 
hexadecimal digit specifying the record 
on that track. 


resource. Any facility of the computing 
system or operating system required by a 
job or task, including main storage, 


input/output devices, the central 
processing unit, data sets, and control 
processing systems. 


RETURN. An Assembler language macro 
instruction that is used to return 
control to the calling CSECT and to 
signal normal termination of the 
returning CSECT. 


ripple. Moving data from one block of a 
chain to the next, due to modification 
of data ina preceding block. 


SAVE. An Assembler language macro 
instruction that causes the contents of 
the specified registers to be stored in 
the save area at the address contained 
in register 13. 


SCRATCH. An Assembler language macro 
instruction that points to the CAMLST 
macro instruction. SCRATCH, the first 
operand of CAMLST, specifies that a data 
set be deleted. 


simple name. The rightmost component of 
a qualified name. For example, "APPLE" 
is the simple name in 
"TREE.FRUIT.APPLE.” The simple name 
corresponds to the lowest index level in 
the CVOL Catalog for the data set name. 


supervisor request block (SVRB). An 
cperating system control block 
containing program status information 
and general register contents. 


SYSCTLG. 
Catalog. 


The data set name of the CVOL 


system residence volume. The volume on 
which the nucleus of the operating 
system is located. 


task control block (TCB)J. An operating 
system control block that contains 
information and pointers associated with 
the task in progress. 


true name. Ina CVOL Catalog, the 
high-level qualifier to which an alias 
is related. 


uncatalog. To remove the catalog entry 
of a data set from a catalog. 


volume control block (VCB). A block of 
the catalog that identifies as many as 
20 volumes containing one data set. 


volume control block pointer entry 
(VCBPE). <A CVOL Catalog entry that 
identifies a VCB for a named data set. 


volume index. The highest level of 
index in the CVOL Catalog structure. 
Entries in the volume index point to all 
lower tndexes and simple names. 


volume index control entry (VICE). The 
first entry in the volume index. The 
VICE describes the volume index and 
controls space allocation is SYSCTLG. 
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volume table of contents (VTOC). A program that the issuing program cannot 

table associated with a direct access continue until a specific event, 

volume that describes each data set on represented by an event control block, | 
that volume and identifies all available has occurred, 

space on the volume. 


XCTL. An Assembler language macro 
WAIT. An Assembler language macro instructton that causes control to be 
instructton that informs the control passed to a specified entry point. 
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